REST Resource: advertisers.youtubeAdGroups

資源：YouTube 廣告群組

與 YouTube 和合作夥伴委刊項相關聯的單一 YouTube 廣告群組。

JSON 表示法 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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 個位元組。
youtubeAdIds[]

string (int64 format)

與廣告群組相關的 [youtube_ad_group_ad][] 資源 ID。
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

廣告群組中的廣告格式。
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

廣告群組使用的出價策略。
entityStatus

enum (EntityStatus)

控制廣告群組是否能支出預算並對廣告空間出價。

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

object (TargetingExpansionConfig)

廣告群組的擴展指定目標設定。

您必須將符合資格的目標對象名單指定目標指派給廣告群組，才適用這項設定。
productFeedData

object (ProductFeedData)

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

YoutubeAndPartnersAdGroupFormat

YouTube 廣告群組的格式，

列舉
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED 未指定格式值，或此版本不知道該格式值。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM 串流內廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY 動態內廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER 串場廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM 不可略過的串流內廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO 不可略過的串流內廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION 影片行動廣告活動的回應式廣告。
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH 有效觸及廣告群組，包含串流內廣告和串場廣告。
YOUTUBE_AND_PARTNERS_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

 列出多個指定類型中，多個 YouTube 廣告群組的指定目標選項。

get

 取得 YouTube 廣告群組。

list

 列出 YouTube 廣告群組。