ProductCustomLabel

项目
11/13/2024

包含用于管理自定义标签产品组的方法。此对象派生自 ProductGroup。

由交付引擎用于确定是否提供广告客户目录中的产品。如果产品的自定义标签与getType 返回的标签完全匹配，则引擎可能会为产品提供服务。

用法示例：

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var productGroups = shoppingCampaign.productGroups().get();

    while (productGroups.hasNext()) {
        var group = productGroups.next();

        switch (group.getDimension()) {
            case "CUSTOM_LABEL": {
                // It's only necessary to cast the product group to a ProductCustomLabel product
                // group if you need to get the label's name by calling getType(). Otherwise,
                // you can simply use ProductGroup if you want to get the label's value by
                // calling getValue().

                var customLabel = productGroup.asCustomLabel();
                var labelName = customLabel.getType();
                var labelValue = customLabel.getValue();
                break;
            }
            // Other cases
        }
    }

方法

方法名称	返回类型	说明
children	ProductGroupSelector	获取用于筛选此产品组子产品组列表的选择器。
getAdGroup	AdGroup	获取此产品组所属的广告组。
getCampaign	市场活动	获取此产品组所属的市场活动。
getDimension	string	获取此产品组的维度。
getEntityType	string	获取此实体的类型。
getId	string	获取唯一标识此产品组的 ID。
getMaxCpc	double	获取此产品组的最大每点击成本出价金额。
getStats	统计	获取此产品组的性能数据。
getType	string	获取产品的自定义标签类型。
getValue	string	获取自定义标签的值。
isExcluded	布尔值	获取一个布尔值，该值确定是否排除此产品组。
isOtherCase	布尔值	获取一个布尔值，该值确定此产品组是否表示其同级产品组未表示的所有其他情况。
父级	ProductGroup	获取此产品组的父产品组。
setMaxCpc (双 cpc)	void	设置要用于此产品组的最大每点击成本出价金额。

children

获取用于筛选此产品组子产品组列表的选择器。

类型	说明
ProductGroupSelector	用于筛选此产品组中子项列表的选择器。

getAdGroup

获取此产品组所属的广告组。

类型	说明
AdGroup	此产品组所属的广告组。

getCampaign

获取此产品组所属的市场活动。

类型	说明
市场活动	此产品组所属的活动。

getDimension

获取此产品组的维度。

类型	说明
String	此产品组的维度，设置为 CUSTOM_LABEL。

getEntityType

获取此实体的类型。

类型	说明
string	此实体的类型为 ProductCustomLabel。

getId

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

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

getMaxCpc

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

类型	说明
double	出价金额。如果未设置，则返回 null，或者这是负产品组， (`isExluded` 为 true) 。

getStats

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

若要调用此方法，必须在产品组选择器的链中包含方法之一forDateRange。

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

getType

获取产品的自定义标签类型。

类型	说明
String	产品的自定义标签类型。例如，CustomLabel0 到 CustomLabel4。

getValue

获取自定义标签的值。

类型	说明
string	自定义标签的值。

isExcluded

获取一个布尔值，该值确定此产品组是否为负产品组。

类型	说明
Boolean	如果此产品组是负组，则为 true ;否则为 false。例如，不要包括所有下坡滑雪板，而是排除它们。

isOtherCase

获取一个布尔值，该值确定此产品组是否表示其同级产品组 (（又名）所表示的其他所有内容，另一种情况) 。

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

父级

获取此产品组的父级。

类型	说明
ProductGroup	此产品组的父级。

setMaxCpc (双 cpc)

设置此产品组的最大每单击成本出价金额。

参数

名称	类型	说明
中国共产党	double	出价金额。出价金额采用帐户的货币，用于确定可以指定的最小和最大出价值。如果此产品组是细分的， (有子级) 或是负产品组， (`isExcluded`为 true) ，请不要设置出价。

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

通过