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/v16/geoTargetConstants:suggest

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

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip 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. Aksi takdirde 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.
Birleştirme alanı query. Zorunlu. Coğrafi hedef sabitleri seçicisi. query şunlardan yalnızca biri olabilir:
locationNames

object (LocationNames)

Aramada kullanılacak konum adları. En fazla 25 ad belirtilebilir.
geoTargets

object (GeoTargets)

Filtrelenecek 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 öğesi listesi.
locale

string

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

string (int64 format)

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

string

İstekte yer adına göre arama yapılırsa bu, coğrafi hedefle eşleşen yer adıdır.