Method: geoTargetConstants.suggest

場所名またはリソース名で GeoTargetConstant の候補を返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

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=Spain となります。locale=es の場合、name=España となります。リクエストでロケールの翻訳が存在しない場合は、デフォルトのロケールが返されます。
reach

string (int64 format)

ターゲットとなるおおよそのユーザー人口で、100 単位で丸められます。
searchTerm

string

リクエストが地域名で検索された場合、これは地域ターゲティングに一致した地域名です。