Method: geoTargetConstants.suggest

ロケーション名またはリソース名で GeoTargetConstant 候補を返します。

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

HTTP リクエスト

POST https://googleads.googleapis.com/v16/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=スペイン」となります。locale=es の場合、name=España となります。リクエスト内の言語 / 地域に対応する翻訳が存在しない場合は、デフォルトの言語 / 地域が返されます。
reach

string (int64 format)

ターゲットとするユーザー数の概算で、100 単位で切り上げられます。
searchTerm

string

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