Method: listPlannableLocations

返回可规划的地理位置列表(例如国家/地区)。

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

HTTP 请求

POST https://googleads.googleapis.com/v16:listPlannableLocations

网址采用 gRPC 转码语法。

请求正文

请求正文必须为空。

响应正文

可规划位置的列表。

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

JSON 表示法
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
字段
plannableLocations[]

object (PlannableLocation)

可进行规划的位置列表。如需查看示例地理位置,请访问 https://developers.google.com/google-ads/api/reference/data/geotargets

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅 OAuth 2.0 概览

PlannableLocation

可规划的位置:国家/地区、都市圈区域、省等

JSON 表示法
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
字段
id

string

位置标识符。

name

string

唯一的地理位置名称(英文)。

parentCountryId

string (int64 format)

父级国家/地区(如果地理位置是国家/地区,则不会显示)。如果存在,将始终是 GeoTargetConstant ID。国家/地区名称等其他信息由 ReachPlanService.ListPlannableLocations 或 GoogleAdsService.Search/SearchStream 提供。

countryCode

string

与营业地点关联的 ISO-3166-1 alpha-2 国家/地区代码。

locationType

string

地理位置的类型。地理位置类型对应于在 GoogleAdsService.Search/SearchStream 中搜索地理位置类型时返回的 targetType。