AdsApp.ProductItemId
Stay organized with collections
Save and categorize content based on your preferences.
Represents a product item ID. Methods:
children()
Returns a selector of the child product groups of this product item id. Return values:
exclude()
Converts the product item id into a negative product item id. Does
nothing if the product item id has children or is already excluded. Returns nothing.
getAdGroup()
Returns the shopping ad group to which this product item id belongs. Return values:
getCampaign()
Returns the shopping campaign to which this product item id belongs. Return values:
getEntityType()
Returns the type of this entity as a String
, in this case, "ProductItemId"
. Return values:
getId()
Returns the ID of the product item id. Return values:
getMaxCpc()
Returns the max cpc bid of the product item id, in the currency of the
account. Returns null
if the campaign's bidding
strategy
is not MANUAL_CPC
or the product item id is
excluded. Return values:
getResourceName()
Returns the resource name of the product item id.
A product group can be identified by an ad_group_criterion resource name or
a product_group_view resource name. This method will return an
ad_group_criterion resource name although either is compatible with ProductGroupSelector.withResourceNames
. Return values:
getStatsFor(dateRange)
Returns stats for the specified date range. Supported values: TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME
.
Example:
var
stats
=
productItemId
.
getStatsFor
(
"THIS_MONTH"
);
Arguments:
Return values:
getStatsFor(dateFrom, dateTo)
Returns stats for the specified custom date range. Both parameters can be
either an object containing year, month, and day fields, or an 8-digit
string in YYYYMMDD
form. For instance, March 24th,
2013
is represented as either {year: 2013, month: 3, day:
24}
or "20130324"
. The date range is inclusive on both
ends, so forDateRange("20130324", "20130324")
defines a range
of a single day. Arguments:
Return values:
getValue()
Returns the value of the product item id or null
if this
is the root product group. Return values:
include()
Converts the product item id into a positive product item id. Does
nothing if the product item id is not excluded. Returns nothing.
isExcluded()
Returns true
if this is an excluded product item id. Return values:
isOtherCase()
Returns true
if the product item id is a catch-all product item id. i.e. 'Everything else'
. Return values:
newChild()
Returns access to the product group builder space or null
if
the
product item id is excluded. Return values:
parent()
Returns the parent product group of this product item id or null
if this is the root product group. Return values:
remove()
Removes the product item id. Returns nothing.
removeAllChildren()
Will remove all child product groups of this product item id. Returns nothing.
setMaxCpc(maxCpc)
Sets the max cpc bid of the product item id to the specified value. The
change will take effect only if the campaign's bidding
strategy
is MANUAL_CPC
and the product item id is not
excluded. Returns nothing.
Arguments:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eRepresents a product item ID within a Shopping campaign hierarchy.\u003c/p\u003e\n"],["\u003cp\u003eProvides methods to manage bids, retrieve performance statistics, and navigate the product group structure.\u003c/p\u003e\n"],["\u003cp\u003eEnables access to parent and child product groups for hierarchical organization.\u003c/p\u003e\n"],["\u003cp\u003eAllows for exclusion or inclusion of specific product items in targeting.\u003c/p\u003e\n"],["\u003cp\u003eOffers functionalities to retrieve essential information like ID, resource name, and entity type.\u003c/p\u003e\n"]]],[],null,[]]
