基本产品组对象,其中包含用于管理 产品组的方法。
示例用法:
var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();
var productGroups = shoppingCampaign.productGroups().get();
while (productGroups.hasNext()) {
var group = productGroups.next();
}
方法
| 方法名称 | 返回类型 | 说明 |
|---|---|---|
| asBrand | ProductBrand | 将产品组强制转换为品牌产品组。 |
| asCategory | ProductCategory | 将产品组强制转换为类别产品组。 |
| asChannel | ProductChannel | 将产品组强制转换为频道产品组。 |
| asChannelExclusivity | ProductChannelExclusivity | 将产品组强制转换为渠道独占产品组。 |
| asCondition | ProductCondition | 将产品组强制转换为条件产品组。 |
| asCustomLabel | ProductCustomLabel | 将产品组强制转换为自定义标签产品组。 |
| asItemId | ProductItemId | 将产品组强制转换为项 ID 产品组。 |
| asProductType | ProductType | 将产品组强制转换为产品类型产品组。 |
| 儿童 | ProductGroupSelector | 获取用于筛选此产品组的子产品组列表的选择器。 |
| getAdGroup | AdGroup | 获取此产品组所属的广告组。 |
| getCampaign | 市场活动 | 获取此产品组所属的市场活动。 |
| getDimension | string | 获取此产品组的维度。 |
| getEntityType | string | 获取此实体的类型。 |
| getId | string | 获取唯一标识此产品组的 ID。 |
| getMaxCpc | double | 获取此产品组的最高每次点击成本出价金额。 |
| getStats | 统计 | 获取此产品组的性能数据。 |
| getValue | String | 获取此产品组的值。 |
| isExcluded | 布尔值 | 获取用于确定是否排除此产品组的布尔值。 |
| isOtherCase | 布尔值 | 获取一个布尔值,该值确定此产品组是否表示其同级产品组未表示的所有其他情况。 |
| parent | ProductGroup | 获取此产品组的父产品组。 |
| setMaxCpc (double cpc) | void | 设置要用于此产品组的最高每次点击成本出价金额。 |
asBrand
将此产品组强制转换为品牌产品组。
注意
无需将产品组强制转换为品牌产品组即可访问品牌的价值。 您可以通过调用 getValue 方法来访问品牌的价值。
返回
| 类型 | 说明 |
|---|---|
| ProductBrand | 包含用于访问产品组属性的方法。 |
asCategory
将此产品组强制转换为类别产品组。
注意
无需将产品组强制转换为类别产品组即可访问该类别的值。 您可以通过调用 getValue 方法来访问类别的值。
返回
| 类型 | 说明 |
|---|---|
| ProductCategory | 包含用于访问产品组属性的方法。 |
asChannel
将此产品组强制转换为频道产品组。
注意
无需将产品组强制转换为频道产品组即可访问该频道的值。 可以通过调用 getValue 方法来访问通道的值。
返回
| 类型 | 说明 |
|---|---|
| ProductChannel | 包含用于访问产品组属性的方法。 |
asChannelExclusivity
将此产品组强制转换为渠道独占产品组。
注意
无需将产品组强制转换为频道独占产品组即可访问该频道的值。 可以通过调用 getValue 方法来访问通道的值。
返回
| 类型 | 说明 |
|---|---|
| ProductChannelExclusivity | 包含用于访问产品组属性的方法。 |
asCondition
将此产品组强制转换为条件产品组。
注意
无需将产品组强制转换为条件产品组即可访问条件的值。 您可以通过调用 getValue 方法来访问条件的值。
返回
| 类型 | 说明 |
|---|---|
| ProductCondition | 包含用于访问产品组属性的方法。 |
asCustomLabel
将此产品组强制转换为自定义标签产品组。
注意
无需将产品组强制转换为 CustomLabel 产品组即可访问标签的值。 您可以通过调用 getValue 方法来访问标签的值。 仅当需要知道值适用于哪个标签类型时,才需要将产品组强制转换为 CustomLabel。 例如,自定义标签 0 到 4。
返回
| 类型 | 说明 |
|---|---|
| ProductCustomLabel | 包含用于访问产品组属性的方法。 |
asItemId
将此产品组强制转换为项 ID 产品组。
注意
无需将产品组强制转换为 ItemId 产品组即可访问 ID 的值。 您可以通过调用 getValue 方法来访问该 ID 的值。
返回
| 类型 | 说明 |
|---|---|
| ProductItemId | 包含用于访问产品组属性的方法。 |
asProductType
将此产品组强制转换为产品类型产品组。
注意
无需将产品组强制转换为 ProductType 产品组即可访问该类型的值。 您可以通过调用 getValue 方法来访问该类型的值。 仅当需要知道值适用于哪种类型时,才需要将产品组强制转换为 ProductType。 例如,PRODUCT_TYPE_L1等。
返回
| 类型 | 说明 |
|---|---|
| ProductType | 包含用于访问产品组属性的方法。 |
children
获取用于筛选此产品组的子产品组列表的选择器
返回
| 类型 | 说明 |
|---|---|
| ProductGroupSelector | 用于筛选此产品组中的子级列表的选择器。 |
getAdGroup
获取此产品组所属的广告组。
返回
| 类型 | 说明 |
|---|---|
| AdGroup | 此产品组所属的广告组。 |
getCampaign
获取此产品组所属的市场活动。
返回
| 类型 | 说明 |
|---|---|
| 市场活动 | 此产品组所属的市场活动。 |
getDimension
获取此产品组的维度。
返回
| 类型 | 说明 |
|---|---|
| String | 此产品组的维度。 可能的值是:
|
getEntityType
获取此实体的类型。
返回
| 类型 | 说明 |
|---|---|
| string | 此实体的类型,即 ProductGroup。 |
getId
获取唯一标识此产品组的 ID。
返回
| 类型 | 说明 |
|---|---|
| string | 唯一标识此产品组的 ID。 |
getMaxCpc
获取此产品组的最高每次点击成本出价金额。
返回
| 类型 | 说明 |
|---|---|
| double | 出价金额。 如果未设置,则返回 null 或这是一个负产品组 (isExluded 为 true) 。 |
getStats
获取此产品组的性能数据。
要调用此方法,必须在产品组选择器的链中包含其中一个forDateRange方法。
返回:
| 类型 | 说明 |
|---|---|
| 统计 | 此产品组的性能数据。 |
getValue
获取此产品组的值。
返回:
| 类型 | 说明 |
|---|---|
| String | 此产品组的值。 如果这是根组,则返回 null。 |
isExcluded
获取用于确定此产品组是否为负产品组的布尔值。
返回:
| 类型 | 说明 |
|---|---|
| Boolean | 如果此产品组为负组,则为 true ;否则为 false。 例如,您不包括所有速降滑雪板,而是将它们排除在外。 |
isOtherCase
获取一个布尔值,该值确定此产品组是否表示其同级产品组 (aka.(另一种情况) )未表示的所有其他内容。
返回:
| 类型 | 说明 |
|---|---|
| Boolean | 如果此产品组代表“其他”情况,则为 true ;否则为 false。 例如,如果按“体育用品”划分根节点 () 的所有产品,则该服务将创建一个同级产品组来表示不在“体育用品”中的产品,并将此字段设置为 true。 此产品组的父 ID 和“体育用品”产品组指向根节点。 |
父级
获取此产品组的父级。
返回:
| 类型 | 说明 |
|---|---|
| ProductGroup | 此产品组的父级。 如果这是根组,则返回 null。 |
setMaxCpc (双 cpc)
设置此产品组的最高每次点击费用出价金额。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| cpc | double | 出价金额。 出价金额以账户货币为单位,该货币决定了您可以指定的最低和最高出价值。 如果此产品组是细分的 (有子项) 或是负产品组 (isExcluded) 是真的 ,请不要设置出价。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |