- HTTP 请求
- 请求正文
- 响应正文
- 授权范围
- ProductMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- PlannableTargeting
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- YouTubeSelectLineUp
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SurfaceTargetingCombinations
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 试试看!
返回具有允许定位的可按位置规划的 YouTube 广告格式的列表。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v17:listPlannableProducts
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "plannableLocationId": string } |
字段 | |
---|---|
plannableLocationId |
必需。用于规划的所选地理位置的 ID。要列出可用的可规划地理位置 ID,请使用 |
响应正文
包含所有可用商品的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"productMetadata": [
{
object ( |
字段 | |
---|---|
productMetadata[] |
可用于规划和相关定位元数据的产品列表。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/adwords
如需了解详情,请参阅 OAuth 2.0 概览。
ProductMetadata
与可用的可规划产品关联的元数据。
JSON 表示法 |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
字段 | |
---|---|
plannableProductName |
与广告产品关联的名称。 |
plannableTargeting |
此产品允许的可规划定位条件。 |
plannableProductCode |
与广告产品关联的代码(例如:BUMPER、TRUEVIEW_IN_STREAM)。如需列出可用的可规划产品代码,请使用 |
PlannableTargeting
要报告流量指标的定位条件。
JSON 表示法 |
---|
{ "ageRanges": [ enum ( |
字段 | |
---|---|
ageRanges[] |
允许为产品报告其指标的可规划年龄段。实际定位是通过将此年龄段映射到标准的 Googlecommon.AgeRangeInfo 值计算得出的。 |
genders[] |
广告产品的可定位性别。 |
devices[] |
广告产品的可定位设备。为 CPM_MASTHEAD、GOOGLE_PREFERRED_BUMPER 和 GOOGLE_PREFERRED_SHORT 产品选择移动设备定位后,TABLET 设备定位会自动应用于报告的指标。 |
networks[] |
广告产品的可定位的广告网络。 |
youtubeSelectLineups[] |
广告产品的可定位 YouTube 优选频道组。 |
surfaceTargeting |
广告产品的可定位界面组合。 |
YouTubeSelectLineUp
用于产品定位的可规划的 YouTube 优选频道组。
JSON 表示法 |
---|
{ "lineupId": string, "lineupName": string } |
字段 | |
---|---|
lineupId |
YouTube 优选频道组的 ID。 |
lineupName |
YouTube 优选频道组的唯一名称。 |
SurfaceTargetingCombinations
适用于广告产品的界面定位组合。
JSON 表示法 |
---|
{ "defaultTargeting": { object ( |
字段 | |
---|---|
defaultTargeting |
应用于广告产品的默认界面定位。 |
availableTargetingCombinations[] |
广告产品的可用平台定位组合。 |