Method: listPlannableLocations

返回可规划位置（例如国家/地区）的列表。

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

HTTP 请求

POST https://googleads.googleapis.com/v14: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 相对应。