- HTTP 请求
- 请求正文
- 响应正文
- 授权范围
- ProductMetadata
- PlannableTargeting
- YouTubeSelectLineUp
- SurfaceTargetingCombinations
- 试试看!
返回按地理位置规划的 YouTube 广告格式的列表(采用允许的定位条件)。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v15: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 产品选择了 MOBILE 定位,系统会自动将 TABLET 设备定位应用于报告的指标。 |
networks[] |
广告产品的可定位广告网络。 |
youtubeSelectLineups[] |
广告产品的可定位 YouTube 优选频道组。 |
surfaceTargeting |
广告产品的可定位界面组合。 |
YouTubeSelectLineUp
用于产品定位的可规划 YouTube 优选频道组。
JSON 表示法 |
---|
{ "lineupId": string, "lineupName": string } |
字段 | |
---|---|
lineupId |
YouTube 优选频道组的 ID。 |
lineupName |
YouTube 优选频道组的唯一名称。 |
SurfaceTargetingCombinations
广告产品可用的平台定位组合。
JSON 表示法 |
---|
{ "defaultTargeting": { object ( |
字段 | |
---|---|
defaultTargeting |
应用于广告产品的默认界面定位条件。 |
availableTargetingCombinations[] |
广告产品的可用平台定位组合。 |