Method: geoTargetConstants.suggest

Konum adına veya kaynak adına göre GeoTargetConstant önerilerini döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi
{
  "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.
}
Alanlar
locale

string

Mümkünse, döndürülen coğrafi hedefler bu yerel ayar kullanılarak çevrilir. Ayarlanmamışsa varsayılan olarak en kullanılır. Bu, döndürülen coğrafi hedefler için bir ipucu olarak da kullanılır.

countryCode

string

Döndürülen coğrafi hedefler bu ülke koduyla sınırlandırılmıştır.

query alanı. Zorunlu. Coğrafi hedef sabitleri seçicisi. query şunlardan yalnızca biri olabilir:
locationNames

object (LocationNames)

Arama yapılacak konum adları. En fazla 25 ad belirlenebilir.

geoTargets

object (GeoTargets)

Filtre ölçütü olarak kullanılacak coğrafi hedef sabit kaynak adları.

Yanıt gövdesi

GeoTargetConstantService.SuggestGeoTargetConstants için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Alanlar
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Coğrafi hedef sabit önerileri.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

LocationNames

Konum adlarının listesi.

JSON gösterimi
{
  "names": [
    string
  ]
}
Alanlar
names[]

string

Konum adlarının listesi.

GeoTargets

Coğrafi hedef sabit kaynak adlarının listesi.

JSON gösterimi
{
  "geoTargetConstants": [
    string
  ]
}
Alanlar
geoTargetConstants[]

string

Coğrafi hedef sabit kaynak adlarının listesi.

GeoTargetConstantSuggestion

Coğrafi hedef sabit önerisi.

JSON gösterimi
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Alanlar
geoTargetConstant

object (GeoTargetConstant)

GeoTargetConstant sonucu.

geoTargetConstantParents[]

object (GeoTargetConstant)

Coğrafi hedef sabitinin üst öğeleri listesi.

locale

string

Bu GeoTargetConstantSuggestion öğesinin şu anda çevrildiği dil. Coğrafi hedef alanlarının adını etkiler. Örneğin, locale=tr ise ad=İspanya. Yerel ayar=es ise name=España. İstekteki yerel ayar için çeviri yoksa varsayılan yerel ayar döndürülür.

reach

string (int64 format)

Hedeflenecek yaklaşık kullanıcı sayısı (en yakın 100'e yuvarlanmış).

searchTerm

string

İstek konum adına göre aranmışsa bu, coğrafi hedefle eşleşen yer adıdır.