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

 列出广告组。