返回可规划位置(例如国家/地区)的列表。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v17: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 相对应。 |