Method: listPlannableProducts

返回按地理位置规划的 YouTube 广告格式的列表（采用允许的定位条件）。

抛出的错误列表：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 请求

POST https://googleads.googleapis.com/v14:listPlannableProducts

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

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

string

必需。用于规划的所选地理位置的 ID。如需列出可用的可规划地理位置 ID，请使用 ReachPlanService.ListPlannableLocations。

响应正文

包含所有可售商品的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
字段
productMetadata[]

object (ProductMetadata)

可用于规划的产品列表和相关定位元数据。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/adwords

有关详情，请参阅 OAuth 2.0 概览。

ProductMetadata

与可用的可规划产品相关联的元数据。

JSON 表示法 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
字段
plannableProductName

string

与广告产品关联的名称。
plannableTargeting

object (PlannableTargeting)

此产品允许的可规划定位条件。
plannableProductCode

string

与广告产品相关联的代码（例如：BUMPER、TRUEVIEW_IN_STREAM）。如需列出可用的可计划商品代码，请使用 ReachPlanService.ListPlannableProducts。

PlannableTargeting

将为其报告流量指标的定位条件。

JSON 表示法 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ]
}
字段
ageRanges[]

enum (ReachPlanAgeRange)

针对要报告指标的产品允许的可规划年龄段。实际定位是通过将此年龄范围映射到标准的 Googlecommon.AgeRangeInfo 值计算出来的。
genders[]

object (GenderInfo)

广告产品的可定位性别。
devices[]

object (DeviceInfo)

广告产品的可定位设备。如果为 CPM_MASTHEAD、GOOGLE_PREFERRED_BUMPER 和 GOOGLE_PREFERRED_SHORT 产品选择了 MOBILE 定位，系统会自动将 TABLET 设备定位应用于报告的指标。
networks[]

enum (ReachPlanNetwork)

广告产品的可定位广告网络。
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

广告产品的可定位 YouTube 优选频道组。

YouTubeSelectLineUp

用于产品定位的可规划 YouTube 优选频道组。

JSON 表示法 
{
  "lineupId": string,
  "lineupName": string
}
字段
lineupId

string (int64 format)

YouTube 优选频道组的 ID。
lineupName

string

YouTube 优选频道组的唯一名称。