按位置名称或资源名称返回 GeoTargetConstant 建议。
抛出的错误列表:AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v15/geoTargetConstants:suggest
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "locale": string, "countryCode": string, // Union field |
字段 | |
---|---|
locale |
如果可能,返回的地理位置定位条件将使用此语言区域进行翻译。如果不包含,则默认使用 en。这也可用作返回的地理位置定位目标的提示。 |
countryCode |
返回的地理位置定位目标仅限于此国家/地区代码。 |
联合字段 query 。必需。地理位置定位常量的选择器。query 只能是下列其中一项: |
|
locationNames |
要搜索的地理位置名称。最多可以设置 25 个名称。 |
geoTargets |
要作为过滤依据的地理位置定位常量资源名称。 |
响应正文
GeoTargetConstantService.SuggestGeoTargetConstants
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"geoTargetConstantSuggestions": [
{
object ( |
字段 | |
---|---|
geoTargetConstantSuggestions[] |
地理位置定位常量建议。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
LocationNames
地理位置名称列表。
JSON 表示法 |
---|
{ "names": [ string ] } |
字段 | |
---|---|
names[] |
地理位置名称列表。 |
GeoTargets
地理位置定位常量资源名称列表。
JSON 表示法 |
---|
{ "geoTargetConstants": [ string ] } |
字段 | |
---|---|
geoTargetConstants[] |
地理位置定位常量资源名称列表。 |
GeoTargetConstantSuggestion
地理位置定位常量建议。
JSON 表示法 |
---|
{ "geoTargetConstant": { object ( |
字段 | |
---|---|
geoTargetConstant |
GeoTargetConstant 结果。 |
geoTargetConstantParents[] |
地理位置定位目标常量的父项列表。 |
locale |
该 GeoTargetConstantSuggestion 目前翻译成的语言。它会影响地理位置定位字段的名称。例如,如果 locale=en,则 name=Spain。如果 locale=es,则 name=España。如果请求中不存在相应语言区域的翻译,则返回默认语言区域。 |
reach |
要定位的用户群体的大概人数(四舍五入到最接近的 100)。 |
searchTerm |
如果请求按地理位置名称搜索,这就是与地理位置定位匹配的地理位置名称。 |