REST Resource: advertisers.adGroups

資源：Ad

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

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)
  }
}
欄位
name

string

廣告群組的資源名稱。
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 欄位能用於出價策略。
entityStatus

enum (EntityStatus)

控制廣告群組是否可以支出預算和對廣告空間出價。

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

object (TargetingExpansionConfig)

廣告群組的最佳化指定目標對象設定。
productFeedData

object (ProductFeedData)

這個廣告群組中的產品動態饋給設定。

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 首頁頂端版位顯示的刊頭廣告。

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

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
欄位
聯集欄位 dimension。用來與產品相符的維度和值。dimension 只能是下列其中一項：
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.

方法

bulkListAdGroupAssignedTargetingOptions

 針對各種指定類型，列出多個廣告群組的指定指定目標選項。

get

 取得廣告群組。

list

 列出廣告群組。