- 資源:AdGroup
- AdGroupFormat
- ProductFeedData
- ProductMatchType
- ProductMatchDimension
- CustomLabel
- CustomLabelKey
- AdGroupInventoryControl
- AdGroupInventoryStrategy
- SelectedInventories
- 方法
資源:AdGroup
與委刊項相關聯的單一廣告群組。
| JSON 表示法 |
|---|
{ "name": string, "advertiserId": string, "adGroupId": string, "lineItemId": string, "displayName": string, "adGroupFormat": enum ( |
| 欄位 | |
|---|---|
name |
僅供輸出。ID。廣告群組的資源名稱。 |
advertiserId |
僅供輸出。廣告群組所屬廣告主的專屬 ID。 |
adGroupId |
僅供輸出。廣告群組的專屬 ID。由系統指派。 |
lineItemId |
必填。不可變動。廣告群組所屬委刊項的專屬 ID。 |
displayName |
必填。廣告群組的顯示名稱。 必須採用 UTF-8 編碼,大小上限為 255 個位元組。 |
adGroupFormat |
必填。不可變動。廣告群組中的廣告格式。 |
bidStrategy |
(選用步驟) 廣告群組採用的出價策略。出價策略只能使用 |
entityStatus |
必填。控制廣告群組是否可支出預算,以及對廣告空間出價。 如果廣告群組的父項委刊項未啟用,即使廣告群組的狀態為 |
targetingExpansion |
(選用步驟) 廣告群組的最佳化指定目標對象設定。 |
productFeedData |
(選用步驟) 這個廣告群組中產品動態饋給的設定。 |
adGroupInventoryControl |
(選用步驟) 需求開發廣告群組必須提供這項資訊。指定廣告群組的廣告空間控制項。 |
AdGroupFormat
廣告群組的格式。
| 列舉 | |
|---|---|
AD_GROUP_FORMAT_UNSPECIFIED |
這個版本未指定格式值,或格式值不明。 |
AD_GROUP_FORMAT_IN_STREAM |
串流內廣告。 |
AD_GROUP_FORMAT_VIDEO_DISCOVERY |
動態內廣告。 |
AD_GROUP_FORMAT_BUMPER |
串場廣告。 |
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM |
不可略過的串流內廣告。 |
AD_GROUP_FORMAT_AUDIO |
不可略過的串流內音訊廣告。 |
AD_GROUP_FORMAT_RESPONSIVE |
回覆式廣告。 |
AD_GROUP_FORMAT_REACH |
有效觸及廣告群組,包括串流內廣告和串場廣告。 |
AD_GROUP_FORMAT_MASTHEAD |
刊頭廣告會顯示在 YouTube 首頁頂端版位。 |
AD_GROUP_FORMAT_DEMAND_GEN |
需求開發廣告。 |
ProductFeedData
產品動態饋給詳細資料。
| JSON 表示法 |
|---|
{ "productMatchType": enum ( |
| 欄位 | |
|---|---|
productMatchType |
產品動態饋給選取產品的方式。 |
productMatchDimensions[] |
用於比對產品的維度清單。 |
isFeedDisabled |
產品動態饋給是否已選擇不顯示產品。 |
ProductMatchType
比對產品的方式類型。
| 列舉 | |
|---|---|
PRODUCT_MATCH_TYPE_UNSPECIFIED |
未指定或不明。 |
PRODUCT_MATCH_TYPE_ALL_PRODUCTS |
所有產品都已完成比對。 |
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS |
已選取特定產品。 |
PRODUCT_MATCH_TYPE_CUSTOM_LABEL |
依自訂標籤比對產品。 |
ProductMatchDimension
用來比對產品的維度。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位 dimension。用來比對產品的維度和值。dimension 只能是下列其中一項: |
|
productOfferId |
產品優惠 ID,用於比對具有相同優惠 ID 的產品。 |
customLabel |
要比對的自訂標籤,所有產品都必須有這個標籤。 |
CustomLabel
自訂標籤的鍵和值。
| JSON 表示法 |
|---|
{
"key": enum ( |
| 欄位 | |
|---|---|
key |
標籤鍵。 |
value |
標籤的值。 |
CustomLabelKey
自訂標籤的鍵
| 列舉 | |
|---|---|
CUSTOM_LABEL_KEY_UNSPECIFIED |
未指定或不明。 |
CUSTOM_LABEL_KEY_0 |
索引鍵 0。 |
CUSTOM_LABEL_KEY_1 |
索引鍵 1。 |
CUSTOM_LABEL_KEY_2 |
索引鍵 2。 |
CUSTOM_LABEL_KEY_3 |
索引鍵 3。 |
CUSTOM_LABEL_KEY_4 |
主要索引 4。 |
AdGroupInventoryControl
廣告群組的廣告空間控制選項。
| JSON 表示法 |
|---|
{ // Union field |
| 欄位 | |
|---|---|
聯集欄位 inventory_controls。廣告群組的廣告空間控制選項。inventory_controls 只能是下列其中一項: |
|
adGroupInventoryStrategy |
廣告空間策略。 |
selectedInventories |
所選廣告空間。 |
AdGroupInventoryStrategy
廣告群組的廣告空間策略。
| 列舉 | |
|---|---|
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED |
未指定或不明。 |
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY |
廣告群組已選擇加入所有 Google 和多媒體廣告聯播網廣告空間。 |
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY |
廣告群組已選擇加入所有 Google 廣告空間。 |
SelectedInventories
廣告群組的廣告空間控制選項。
| JSON 表示法 |
|---|
{ "allowYoutubeStream": boolean, "allowYoutubeShorts": boolean, "allowYoutubeFeed": boolean, "allowDiscover": boolean, "allowGmail": boolean, "allowGoogleDisplayNetwork": boolean } |
| 欄位 | |
|---|---|
allowYoutubeStream |
廣告群組是否已啟用 YouTube 串流內廣告空間。 |
allowYoutubeShorts |
廣告群組是否已選擇加入 YouTube Shorts 廣告空間。 |
allowYoutubeFeed |
廣告群組是否已啟用 YouTube 動態內廣告空間。 |
allowDiscover |
廣告群組是否已啟用探索廣告空間。 |
allowGmail |
廣告群組是否已選擇加入 Gmail 廣告空間。 |
allowGoogleDisplayNetwork |
廣告群組是否已啟用 Google 多媒體廣告聯播網廣告空間。 |
方法 |
|
|---|---|
|
大量編輯多個廣告群組的指定目標選項。 |
|
列出多個廣告群組在不同指定類型中指派的指定目標選項。 |
|
建立新的廣告群組。 |
|
刪除廣告群組。 |
|
取得廣告群組。 |
|
列出廣告群組。 |
|
更新現有廣告群組。 |