產品群組

基礎產品群組物件，包含用來管理 產品群組的方法。

使用範例：

    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	廣告群組	取得此產品群組所屬的廣告群組。
getCampaign	行銷活動	取得此產品群組所屬的廣告活動。
getDimension	字串	取得此產品群組的維度。
getEntityType	字串	取得此實體的類型。
getId	字串	取得唯一識別此產品群組的識別碼。
getMaxCpc	double	取得此產品群組的每次點選成本出價上限。
getStats	統計資料	取得此產品群組的成效資料。
getValue	字串	取得此產品群組的值。
isExcluded	布林值	取得布林值，判斷是否排除此產品群組。
isOtherCase	布林值	取得布林值，判斷此產品群組是否代表其同層級產品群組未代表的所有其他案例。
父系	產品群組	取得此產品群組的上層產品群組。
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

將此產品群組投射到項目識別碼產品群組。

注意事項

不一定要將產品群組投射到 ItemId 產品群組就能存取識別碼的值。 您可以呼叫 getValue 方法來存取識別碼的值。

傳回

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

asProductType

將此產品群組投射到產品類型產品群組。

注意事項

不需要為了存取類型的值，將產品群組投射到 ProductType 產品群組。 您可以呼叫 getValue 方法來存取類型的值。 只有在需要知道值屬於哪種類型時，才需要將產品群組投射到 ProductType。 例如，PRODUCT_TYPE_L1等。

傳回

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

兒童

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

傳回

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

getAdGroup

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

傳回

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

getCampaign

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

傳回

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

getDimension

取得此產品群組的維度。

傳回

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

getEntityType

取得此實體的類型。

傳回

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

getId

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

傳回

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

getMaxCpc

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

傳回

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

getStats

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

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

傳回：

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

getValue

取得此產品群組的值。

傳回：

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

isExcluded

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

傳回：

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

isOtherCase

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

傳回：

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

母

取得此產品群組的父系。

傳回：

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

setMaxCpc (double cpc)

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

引數

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

傳回

類型	描述
void	會傳回 nothing。