REST Resource: advertisers.youtubeAdGroups

资源：YoutubeAdGroup

与 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)

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

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

商品 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

 列出为多个 YouTube 广告组分配的定位选项（按定位类型）。

get

 获取 YouTube 广告组。

list

 列出 YouTube 广告组。