Method: listPlannableProducts

返回具有允许定位的可按位置规划的 YouTube 广告格式的列表。

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

HTTP 请求

POST https://googleads.googleapis.com/v16: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)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
字段
ageRanges[]

enum (ReachPlanAgeRange)

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

object (GenderInfo)

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

object (DeviceInfo)

广告产品的可定位设备。为 CPM_MASTHEAD、GOOGLE_PREFERRED_BUMPER 和 GOOGLE_PREFERRED_SHORT 产品选择移动设备定位后，TABLET 设备定位会自动应用于报告的指标。
networks[]

enum (ReachPlanNetwork)

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

object (YouTubeSelectLineUp)

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

object (SurfaceTargetingCombinations)

广告产品的可定位界面组合。

YouTubeSelectLineUp

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

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

string (int64 format)

YouTube 优选频道组的 ID。
lineupName

string

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

SurfaceTargetingCombinations

适用于广告产品的界面定位组合。

JSON 表示法 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
字段
defaultTargeting

object (SurfaceTargeting)

应用于广告产品的默认界面定位。
availableTargetingCombinations[]

object (SurfaceTargeting)

广告产品的可用平台定位组合。