返回可规划位置(例如国家/地区)的列表。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v14:listPlannableLocations
网址采用 gRPC 转码语法。
请求正文
请求正文必须为空。
响应正文
可规划位置的列表。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"plannableLocations": [
{
object ( |
字段 | |
---|---|
plannableLocations[] |
可供规划的位置列表。有关地理位置示例,请参阅 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 |
位置标识符。 |
name |
唯一的地理位置名称(英文)。 |
parentCountryId |
上级国家/地区(如果地理位置是国家/地区,则不存在)。如果存在,将始终是 GeoTargetConstant ID。国家/地区名称等其他信息由 |
countryCode |
与营业地点关联的 ISO-3166-1 alpha-2 国家/地区代码。 |
locationType |
营业地点的类型。地理位置类型与在 GoogleAdsService.Search/SearchStream 中搜索地理位置类型时返回的 targetType 相对应。 |