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)

此广告组中产品 Feed 的设置。

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

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

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

 列出广告组。