Method: geoTargetConstants.suggest

依位置名稱或資源名稱傳回 GeoTargetConstant 建議。

擲回錯誤清單：AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v16/geoTargetConstants:suggest

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
欄位
locale

string

系統會盡可能使用這個地區語言翻譯傳回的指定地理區域。如果不是，則預設使用 en。也可以做為傳回的指定地理區域提示。
countryCode

string

傳回的指定地理區域僅限於這個國家/地區代碼。
聯集欄位 query。必要欄位。指定地理區域常數的選取器。query 只能是下列其中一項：
locationNames

object (LocationNames)

要搜尋的地區名稱。最多只能設定 25 個名稱。
geoTargets

object (GeoTargets)

要做為篩選依據的指定地理區域常數資源名稱。

回應主體

「GeoTargetConstantService.SuggestGeoTargetConstants」的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
欄位
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

指定地理區域常數建議。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

LocationNames

地區名稱清單。

JSON 表示法 
{
  "names": [
    string
  ]
}
欄位
names[]

string

地區名稱清單。

GeoTargets

指定地理區域常數資源名稱的清單。

JSON 表示法 
{
  "geoTargetConstants": [
    string
  ]
}
欄位
geoTargetConstants[]

string

指定地理區域常數資源名稱的清單。

GeoTargetConstantSuggestion

指定地理區域常數建議。

JSON 表示法 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
欄位
geoTargetConstant

object (GeoTargetConstant)

GeoTargetConstant 結果。
geoTargetConstantParents[]

object (GeoTargetConstant)

指定地理區域常數的父項清單。
locale

string

這個 GeoTargetConstantsuggestion 目前要翻譯成的語言。會影響指定地理區域欄位的名稱。舉例來說，如果 locale=en，name=西班牙。如果 locale=es，name=España。如果要求中的語言代碼沒有翻譯，則系統會傳回預設語言代碼。
reach

string (int64 format)

大致指定的使用者人口數，四捨五入為最接近的 100 位數。
searchTerm

string

如果要求是按地區名稱搜尋，這就是與指定地理區域相符的地區名稱。