場所名またはリソース名で 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 |
フィールド | |
---|---|
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 |
リクエストが地域名で検索された場合、これは地域ターゲティングに一致した地域名です。 |