ProductGroup

基本产品组对象,其中包含用于管理 产品组的方法。

示例用法:

    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 此产品组的维度。 可能的值是:
  • ROOT — 树的顶部
  • 品牌
  • 类别
  • 条件
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

获取此实体的类型。

返回

类型 说明
string 此实体的类型,即 ProductGroup

getId

获取唯一标识此产品组的 ID。

返回

类型 说明
string 唯一标识此产品组的 ID。

getMaxCpc

获取此产品组的最高每次点击成本出价金额。

返回

类型 说明
double 出价金额。 如果未设置,则返回 null 或这是一个负产品组 (isExludedtrue) 。

getStats

获取此产品组的性能数据。

要调用此方法,必须在产品组选择器的链中包含其中一个forDateRange方法。

返回:

类型 说明
统计 此产品组的性能数据。

getValue

获取此产品组的值。

返回:

类型 说明
String 此产品组的值。 如果这是根组,则返回 null。

isExcluded

获取用于确定此产品组是否为负产品组的布尔值。

返回:

类型 说明
Boolean 如果此产品组为负组,则为 true ;否则为 false。 例如,您不包括所有速降滑雪板,而是将它们排除在外。

isOtherCase

获取一个布尔值,该值确定此产品组是否表示其同级产品组 (aka.(另一种情况) )未表示的所有其他内容。

返回:

类型 说明
Boolean 如果此产品组代表“其他”情况,则为 true ;否则为 false。 例如,如果按“体育用品”划分根节点 () 的所有产品,则该服务将创建一个同级产品组来表示不在“体育用品”中的产品,并将此字段设置为 true。 此产品组的父 ID 和“体育用品”产品组指向根节点。

父级

获取此产品组的父级。

返回:

类型 说明
ProductGroup 此产品组的父级。 如果这是根组,则返回 null。

setMaxCpc (双 cpc)

设置此产品组的最高每次点击费用出价金额。

参数

名称 类型 说明
cpc double 出价金额。 出价金额以账户货币为单位,该货币决定了您可以指定的最低和最高出价值。 如果此产品组是细分的 (有子项) 或是负产品组 (isExcluded) 是真的 ,请不要设置出价。

返回

类型 说明
void 不返回任何内容。