Method: geoTargetConstants.suggest

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

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

HTTP 要求

POST https://googleads.googleapis.com/v14/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

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

string (int64 format)

概略的目標使用者人口數，會四捨五入為最接近的 100 倍數。
searchTerm

string

如果廣告請求是按地區名稱搜尋，表示與指定地理區域相符的地區名稱。