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	將產品群組轉換成專案識別碼產品群組。
asProductType	ProductType	將產品群組轉換成產品類型產品群組。
孩子	ProductGroupSelector	取得選取器，用來篩選此產品群組的子產品群組清單。
getAdGroup	AdGroup	取得此產品群組所屬的廣告群組。
getCampaign	行銷活動	取得此產品群組所屬的行銷活動。
getDimension	字串	取得此產品群組的維度。
getEntityType	字串	取得這個實體的類型。
getId	字串	取得可唯一識別此產品群組的識別碼。
getMaxCpc	double	取得此產品群組的按鍵付費率上限。
getStats	統計	取得此產品群組的效能資料。
getValue	字串	取得此產品群組的值。
isExcluded	布林值	取得布林值，判斷是否排除此產品群組。
isOtherCase	布林值	取得布林值，判斷此產品群組是否代表其同層級產品群組未表示的所有其他案例。
母	ProductGroup	取得此產品群組的父產品群組。
setMaxCpc (雙精度浮點數)	void	設定要用於此產品群組的按鍵付費率上限。

asBrand

將此產品群組轉換成品牌產品群組。

注意事項

不需要將產品群組轉換成品牌產品群組，即可存取品牌的價值。 您可以呼叫 getValue 方法來存取品牌的值。

傳回

類型	說明
ProductBrand	包含用來存取產品群組屬性的方法。

asCategory

將此產品群組轉換成類別產品群組。

注意事項

不需要將產品群組轉換成 Category 產品群組，即可存取類別的值。 您可以呼叫 getValue 方法來存取類別的值。

傳回

類型	說明
ProductCategory	包含用來存取產品群組屬性的方法。

asChannel

將此產品群組轉換成 Channel 產品群組。

注意事項

不需要將產品群組轉換成通道產品群組，即可存取通道的值。 您可以呼叫 getValue 方法來存取通道的值。

傳回

類型	說明
ProductChannel	包含用來存取產品群組屬性的方法。

asChannelExclusivity

將此產品群組轉換成通道排除性產品群組。

注意事項

不需要將產品群組轉換成通道排除性產品群組，即可存取通道的值。 您可以呼叫 getValue 方法來存取通道的值。

傳回

類型	說明
ProductChannelExclusivity	包含用來存取產品群組屬性的方法。

asCondition

將此產品群組轉換成條件產品群組。

注意事項

不需要將產品群組轉換成條件產品群組，即可存取條件的值。 您可以呼叫 getValue 方法來存取條件的值。

傳回

類型	說明
ProductCondition	包含用來存取產品群組屬性的方法。

asCustomLabel

將此產品群組轉換成自訂標籤產品群組。

注意事項

不需要將產品群組轉換成 CustomLabel 產品群組，即可存取標籤的值。 您可以呼叫 getValue 方法來存取標籤的值。 如果您需要知道該值的標籤類型，您只需要將產品群組轉換成 CustomLabel。 例如，自訂標籤 0 到 4。

傳回

類型	說明
ProductCustomLabel	包含用來存取產品群組屬性的方法。

asItemId

將此產品群組轉換成專案識別碼產品群組。

注意事項

不需要將產品群組轉換成 ItemId 產品群組，即可存取識別碼的值。 您可以呼叫 getValue 方法來存取識別碼的值。

傳回

類型	說明
ProductItemId	包含用來存取產品群組屬性的方法。

asProductType

將此產品群組轉換成產品類型產品群組。

注意事項

不需要將產品群組轉換成 ProductType 產品群組，即可存取類型的值。 您可以呼叫 getValue 方法來存取類型的值。 如果您需要知道該值的類型，您只需要將產品群組轉換成 ProductType。 例如，PRODUCT_TYPE_L1等等。

傳回

類型	說明
ProductType	包含用來存取產品群組屬性的方法。

孩子

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

傳回

類型	說明
ProductGroupSelector	用來篩選此產品群組中子系列表的選取器。

getAdGroup

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

傳回

類型	說明
AdGroup	此產品群組所屬的廣告群組。

getCampaign

取得此產品群組所屬的行銷活動。

傳回

類型	說明
行銷活動	此產品群組所屬的行銷活動。

getDimension

取得此產品群組的維度。

傳回

類型	描述
字串	此產品群組的維度。 可能的值為： ROOT - 樹狀結構的頂端 品牌 類別 條件 CUSTOM_LABEL ITEM_ID PRODUCT_TYPE

getEntityType

取得這個實體的類型。

傳回

類型	描述
字串	此實體的類型，也就是 ProductGroup。

getId

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

傳回

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

getMaxCpc

取得此產品群組的按下按一下費用上限。

傳回

類型	說明
double	中標金額。 如果未設定，或這是負產品群組， (為true，則 isExluded 傳回 null) 。

getStats

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

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

傳回：

類型	說明
統計	此產品群組的效能資料。

getValue

取得此產品群組的值。

傳回：

類型	描述
字串	此產品群組的值。 如果這是根群組，則傳回 null。

isExcluded

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

傳回：

類型	說明
布林值	如果此產品群組是負數群組，則為 true ;否則為 false。 例如，您不會包含所有下坡滑板，而是將其排除。

isOtherCase

取得布林值，判斷此產品群組是否代表其同層級產品群組 (aka.，另一個案例) 。

傳回：

類型	說明
布林值	如果此產品群組代表「其他」案例，則為 true ;否則為 false。 例如，如果您將 [所有產品] 分割 (根節點) ，服務會建立一個同層級產品群組，代表不在[商品] 中的產品，並將此欄位設定為 true。 此產品群組的父識別碼和「商品」產品群組會指向根節點。

母

取得此產品群組的父系。

傳回：

類型	說明
ProductGroup	此產品群組的父系。 如果這是根群組，則傳回 null。

setMaxCpc (雙精度)

設定此產品群組的按鍵付費率上限。

引數

名稱	類型	說明
中國共產黨	double	中標金額。 中標金額是以帳戶的貨幣表示，這會決定您可能指定的最小和最大報價值。 如果此產品群組已細分， (子系) 或是負數產品群組， (isExcluded 為 true ，請勿設定) 。

傳回

類型	說明
void	會傳回 nothing。