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

(選用步驟) 廣告群組採用的出價策略。出價策略只能使用 youtubeAndPartnersBiddemandGenBid 欄位。

entityStatus

enum (EntityStatus)

必填。控制廣告群組是否可支出預算,以及對廣告空間出價。

如果廣告群組的父項委刊項未啟用,即使廣告群組的狀態為 ENTITY_STATUS_ACTIVE,也無法支出預算。

targetingExpansion

object (TargetingExpansionConfig)

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

productFeedData

object (ProductFeedData)

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

adGroupInventoryControl

object (AdGroupInventoryControl)

(選用步驟) 需求開發廣告群組必須提供這項資訊。指定廣告群組的廣告空間控制項。

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

  // 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。

AdGroupInventoryControl

廣告群組的廣告空間控制選項。

JSON 表示法
{

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
欄位
聯集欄位 inventory_controls。廣告群組的廣告空間控制選項。inventory_controls 只能是下列其中一項:
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 多媒體廣告聯播網廣告空間。

方法

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

建立新的廣告群組。

delete

刪除廣告群組。

get

取得廣告群組。

list

列出廣告群組。

patch

更新現有廣告群組。