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)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
字段
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 和 demandGenBid 字段。

entityStatus

enum (EntityStatus)

必需。控制广告组能否支出预算以及能否对广告资源出价。

如果广告组的父级订单项未处于有效状态,则即使广告组自身的状态为ENTITY_STATUS_ACTIVE,也无法支出其预算。

targetingExpansion

object (TargetingExpansionConfig)

可选。广告组的优化型定位设置。

productFeedData

object (ProductFeedData)

可选。此广告组中商品 Feed 的设置。

adGroupInventoryControl

object (AdGroupInventoryControl)

可选。需求开发广告组必须提供此字段。指定广告组的广告资源控制。

adSource

enum (AdSource)

可选。此广告组下广告的来源。此字段仅在广告是根据给定来源自动生成时使用。

creativeAssignments[]

object (CreativeAssignment)

可选。用于在广告组下生成广告的广告素材。

仅当 adSource 为 AD_SOURCE_DV360_CREATIVE 时,才能分配此字段。

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

商品 Feed 的详细信息。

JSON 表示法
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
字段
productMatchType

enum (ProductMatchType)

商品 Feed 如何选择商品。

productMatchDimensions[]

object (ProductMatchDimension)

用于匹配商品的维度列表。

isFeedDisabled

boolean

商品 Feed 是否已选择退出展示商品。

ProductMatchType

商品匹配方式的类型。

枚举
PRODUCT_MATCH_TYPE_UNSPECIFIED 未指定或未知。
PRODUCT_MATCH_TYPE_ALL_PRODUCTS 所有商品均已匹配。
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS 已选择指定商品。
PRODUCT_MATCH_TYPE_CUSTOM_LABEL 按商品的自定义标签进行匹配。

ProductMatchDimension

用于匹配商品的维度。

JSON 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
字段
用于匹配商品的维度和值。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
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 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
字段
广告组的广告资源控制。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
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 展示广告网络广告资源。

AdSource

此广告组下广告的来源。

枚举
AD_SOURCE_UNSPECIFIED 未指定或未知。默认值为常规广告来源。
AD_SOURCE_DV360_CREATIVE 源自 DV360 广告素材。

CreativeAssignment

分配给广告组的广告素材的详细信息。

JSON 表示法
{
  "creativeId": string
}
字段
creativeId

string (int64 format)

必需。分配给广告组的 Display & Video 360 广告素材的 ID。

方法

bulkEditAssignedTargetingOptions

批量修改多个广告组的定位选项。

bulkListAssignedTargetingOptions

列出多个广告组在各种定位类型中分配的定位选项。

create

创建新广告组。

delete

删除广告组。

get

获取广告组。

list

列出广告组。

patch

更新现有广告组。