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)

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