ProductCustomLabel

包含管理自訂標籤產品群組的方法。 此物件衍生自 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
        }
    }

方法

方法名稱	傳回類型	描述
兒童	ProductGroupSelector	取得用來篩選此產品群組子產品群組清單的選取器。
getAdGroup	廣告群組	取得此產品群組所屬的廣告群組。
getCampaign	行銷活動	取得此產品群組所屬的廣告活動。
getDimension	字串	取得此產品群組的維度。
getEntityType	字串	取得此實體的類型。
getId	字串	取得唯一識別此產品群組的識別碼。
getMaxCpc	double	取得此產品群組的每次點選成本出價上限。
getStats	統計資料	取得此產品群組的成效資料。
getType	字串	取得產品的自訂標籤類型。
getValue	字串	取得自訂標籤的值。
isExcluded	布林值	取得布林值，判斷是否排除此產品群組。
isOtherCase	布林值	取得布林值，判斷此產品群組是否代表其同層級產品群組未代表的所有其他案例。
父系	產品群組	取得此產品群組的上層產品群組。
setMaxCpc (double cpc)	void	設定要用於此產品群組的每次點選成本出價上限。

兒童

取得用來篩選此產品群組子產品群組清單的 選取器 。

傳回

類型	描述
ProductGroupSelector	用來篩選此產品群組中子系清單的選取器。

getAdGroup

取得此產品群組所屬的廣告群組。

傳回

類型	描述
廣告群組	此產品群組所屬的廣告群組。

getCampaign

取得此產品群組所屬的廣告活動。

傳回

類型	描述
行銷活動	此產品群組所屬的廣告活動。

getDimension

取得此產品群組的維度。

傳回

類型	描述
字串	此產品群組的維度設定為 CUSTOM_LABEL。

getEntityType

取得此實體的類型。

傳回

類型	描述
字串	此實體的類型，即 ProductCustomLabel。

getId

取得唯一識別此產品群組的識別碼。

傳回

類型	描述
字串	唯一識別此產品群組的 ID。

getMaxCpc

取得此產品群組的每次點選成本出價上限。

傳回

類型	描述
double	出價金額。 如果未設定，則傳回 null (這是負數產品群組) isExluded 為 True 。

getStats

取得此產品群組的成效資料。

若要呼叫此方法，您必須在產品群組選取器的鏈結中包含其中一個forDateRange方法。

傳回：

類型	描述
統計資料	此產品群組的成效資料。

getType

取得產品的自訂標籤類型。

傳回

類型	描述
字串	產品的自訂標籤類型。 例如，CustomLabel0 到 CustomLabel4。

getValue

取得自訂標籤的值。

傳回：

類型	描述
字串	自訂標籤的值。

isExcluded

取得布林值，判斷此產品群組是否為負數產品群組。

傳回：

類型	描述
布林值	如果此產品群組為負數群組，則為 True ;否則為 false。 例如，您不是包括所有速降滑雪板，而是排除它們。

isOtherCase

取得布林值，判斷此產品群組是否代表未由其同層級產品群組代表的所有項目 (aka.，另一種情況) 。

傳回：

類型	描述
布林值	如果此產品群組代表「其他」案例，則為 True ;否則為 false。 例如，如果您將根節點) ([所有產品] 依 [運動用品] 劃分，服務就會建立一個兄弟產品群組來代表不在 [運動用品] 中的產品，並將此欄位設定為 True。 此產品群組的父識別碼和運動用品產品群組指向根節點。

母

取得此產品群組的父系。

傳回：

類型	描述
產品群組	此產品群組的父系。

setMaxCpc (double cpc)

設定此產品群組的每次點選成本出價上限。

引數

名稱	類型	描述
每次點選成本	double	出價金額。 出價金額以帳戶的貨幣計算，而該貨幣決定了您可以指定的最低和最高出價值。 如果此產品群組已細分 (有子系) ，或屬於負數產品群組 (isExcluded 則請勿設定出價，但 true) 。

傳回

類型	描述
void	會傳回 nothing。