Method: listPlannableLocations

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

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

HTTP 请求

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