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

 列出廣告群組。