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 | 将产品组强制转换为产品类型产品组。 |
children | ProductGroupSelector | 获取用于筛选此产品组子产品组列表的选择器。 |
getAdGroup | AdGroup | 获取此产品组所属的广告组。 |
getCampaign | 市场活动 | 获取此产品组所属的市场活动。 |
getDimension | string | 获取此产品组的维度。 |
getEntityType | string | 获取此实体的类型。 |
getId | string | 获取唯一标识此产品组的 ID。 |
getMaxCpc | double | 获取此产品组的最大每点击成本出价金额。 |
getStats | 统计 | 获取此产品组的性能数据。 |
getValue | String | 获取此产品组的值。 |
isExcluded | 布尔值 | 获取一个布尔值,该值确定是否排除此产品组。 |
isOtherCase | 布尔值 | 获取一个布尔值,该值确定此产品组是否表示其同级产品组未表示的所有其他情况。 |
父级 | ProductGroup | 获取此产品组的父产品组。 |
setMaxCpc (双 cpc) | void | 设置要用于此产品组的最大每点击成本出价金额。 |
asBrand
将此产品组转换为品牌产品组。
注意
无需将产品组强制转换为品牌产品组来访问品牌的价值。 可以通过调用 getValue 方法访问品牌的值。
返回
类型 | 说明 |
---|---|
ProductBrand | 包含用于访问产品组属性的方法。 |
asCategory
将此产品组强制转换为类别产品组。
注意
无需将产品组强制转换为 Category 产品组来访问类别的值。 可以通过调用 getValue 方法访问类别的值。
返回
类型 | 说明 |
---|---|
ProductCategory | 包含用于访问产品组属性的方法。 |
asChannel
将此产品组转换为频道产品组。
注意
无需将产品组强制转换为 Channel 产品组来访问通道的值。 可以通过调用 getValue 方法访问通道的值。
返回
类型 | 说明 |
---|---|
ProductChannel | 包含用于访问产品组属性的方法。 |
asChannelExclusivity
将此产品组转换为频道独占性产品组。
注意
无需将产品组强制转换为 Channel 独占性产品组来访问通道的值。 可以通过调用 getValue 方法访问通道的值。
返回
类型 | 说明 |
---|---|
ProductChannelExclusivity | 包含用于访问产品组属性的方法。 |
asCondition
将此产品组强制转换为条件产品组。
注意
无需将产品组强制转换为 Condition 产品组来访问条件的值。 可以通过调用 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
获取一个布尔值,该值确定此产品组是否表示其同级产品组 ((又名)所表示的其他所有内容,另一种情况) 。
返回:
类型 | 说明 |
---|---|
Boolean | 如果此产品组表示“其他”情况,则 为 true ;否则为 false。 例如,如果将“所有产品” (根节点除以“体育用品) ”,则服务将创建一个表示非体育用品中的产品的同级产品组,并将此字段设置为 true。 此产品组和体育用品产品组的父 ID 指向根节点。 |
父级
获取此产品组的父级。
返回:
类型 | 说明 |
---|---|
ProductGroup | 此产品组的父级。 如果这是根组,则返回 null。 |
setMaxCpc (双 cpc)
设置此产品组的最大每单击成本出价金额。
参数
名称 | 类型 | 说明 |
---|---|---|
中国共产党 | double | 出价金额。 出价金额采用帐户的货币,用于确定可以指定的最小和最大出价值。 如果此产品组是细分的, (有子级) 或是负产品组, (isExcluded 为 true) ,请不要设置出价。 |
返回
类型 | 说明 |
---|---|
void | 不返回任何内容。 |