REST Resource: advertisers.adGroups

資源：AdGroup

與委刊項相關聯的單一廣告群組。

JSON 表示法 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
欄位
name

string

僅供輸出。ID。廣告群組的資源名稱。
advertiserId

string (int64 format)

僅供輸出。廣告群組所屬廣告主的專屬 ID。
adGroupId

string (int64 format)

僅供輸出。廣告群組的專屬 ID。由系統指派。
lineItemId

string (int64 format)

必填。不可變動。廣告群組所屬委刊項的專屬 ID。
displayName

string

必填。廣告群組的顯示名稱。

必須採用 UTF-8 編碼，大小上限為 255 個位元組。
adGroupFormat

enum (AdGroupFormat)

必填。不可變動。廣告群組中的廣告格式。
bidStrategy

object (BiddingStrategy)

(選用步驟) 廣告群組使用的出價策略。出價策略只能使用 youtubeAndPartnersBid 和 demandGenBid 欄位。
entityStatus

enum (EntityStatus)

必填。控制廣告群組是否能使用預算，以及對廣告空間出價。

如果廣告群組的上層委刊項未啟用，即使廣告群組本身的狀態為「ENTITY_STATUS_ACTIVE」，也無法支出預算。
targetingExpansion

object (TargetingExpansionConfig)

(選用步驟) 廣告群組的最佳化指定目標對象設定。
productFeedData

object (ProductFeedData)

(選用步驟) 這個廣告群組中的產品動態饋給設定。
adGroupInventoryControl

object (AdGroupInventoryControl)

(選用步驟) 需求開發廣告群組必須提供。指定廣告群組的廣告空間控管。
adSource

enum (AdSource)

(選用步驟) 這個廣告群組中廣告的來源。只有在系統自動從指定來源產生廣告時，才會使用這個欄位。
creativeAssignments[]

object (CreativeAssignment)

(選用步驟) 用於在廣告群組中產生廣告的廣告素材。

只有在 adSource 為 AD_SOURCE_DV360_CREATIVE 時，才能指派這個欄位。

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": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
欄位
productMatchType

enum (ProductMatchType)

產品動態饋給如何選取產品。
productMatchDimensions[]

object (ProductMatchDimension)

用於比對產品的維度清單。
isFeedDisabled

boolean

產品動態饋給是否已選擇不顯示產品。

ProductMatchType

產品比對方式的類型。

列舉
PRODUCT_MATCH_TYPE_UNSPECIFIED 未指定或不明。
PRODUCT_MATCH_TYPE_ALL_PRODUCTS 所有產品都相符。
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS 已選取特定產品。
PRODUCT_MATCH_TYPE_CUSTOM_LABEL 依自訂標籤比對產品。

ProductMatchDimension

用於比對產品的維度。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
欄位
用於比對產品的維度和值。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
productOfferId

string

產品優惠 ID，用於比對優惠 ID 相同的產品。
customLabel

object (CustomLabel)

自訂標籤，用於比對所有含有該標籤的產品。
互斥欄位結束。

CustomLabel

自訂標籤的鍵和值。

JSON 表示法 
{
  "key": enum (CustomLabelKey),
  "value": string
}
欄位
key

enum (CustomLabelKey)

標籤的鍵。
value

string

標籤的值。

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 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
欄位
廣告群組的廣告空間控管。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

商品目錄策略。
selectedInventories

object (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

boolean

廣告群組是否已選擇加入 YouTube 串流內廣告空間。
allowYoutubeShorts

boolean

廣告群組是否已選擇加入 YouTube Shorts 廣告空間。
allowYoutubeFeed

boolean

廣告群組是否已選擇加入 YouTube 動態內廣告空間。
allowDiscover

boolean

廣告群組是否已選擇加入探索廣告空間。
allowGmail

boolean

廣告群組是否選擇加入 Gmail 廣告空間。
allowGoogleDisplayNetwork

boolean

廣告群組是否已選擇加入 Google 多媒體廣告聯播網廣告空間。

AdSource

這個廣告群組中廣告的來源。

列舉
AD_SOURCE_UNSPECIFIED 未指定或不明。預設為一般廣告來源。
AD_SOURCE_DV360_CREATIVE 來源為 DV360 廣告素材。

CreativeAssignment

指派給廣告群組的廣告素材詳細資料。

JSON 表示法 
{
  "creativeId": string
}
欄位
creativeId

string (int64 format)

必填。指派給廣告群組的 Display & Video 360 廣告素材 ID。

方法

bulkEditAssignedTargetingOptions

 大量編輯多個廣告群組的指定目標選項。

bulkListAssignedTargetingOptions

 列出多個廣告群組在不同指定類型中指派的指定目標選項。

create

 建立新的廣告群組。

delete

 刪除廣告群組。

get

 取得廣告群組。

list

 列出廣告群組。

patch

 更新現有廣告群組。