基底產品群組物件,其中包含用來管理 產品群組的方法。
範例使用方式:
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
取得此產品群組的維度。
傳回
| 類型 | 描述 |
|---|---|
| 字串 | 此產品群組的維度。 可能的值為:
|
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。 |