REST Resource: advertisers.adGroups

資源:廣告群組

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

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

列出廣告群組。