Method: geoTargetConstants.suggest

Zwraca sugestie GeoTargetConstant według nazwy lokalizacji lub nazwy zasobu.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
locale

string

Jeśli to możliwe, zwrócone dane geograficzne są tłumaczone z użyciem tego języka. Jeśli nie, domyślnie używany jest en. Działa ona też jako wskazówka w przypadku zwróconych celów geograficznych.

countryCode

string

Zwrócone cele geograficzne są ograniczone do tego kodu kraju.

Pole sumy query. To pole jest wymagane. Selektor stałych kierowania geograficznego. query może być tylko jedną z tych wartości:
locationNames

object (LocationNames)

Nazwy lokalizacji, według których chcesz wyszukiwać. Można ustawić maksymalnie 25 nazw.

geoTargets

object (GeoTargets)

Nazwy zasobów stałych w kierowaniu geograficznym, według których chcesz filtrować.

Treść odpowiedzi

Odpowiedź na pytanie: GeoTargetConstantService.SuggestGeoTargetConstants.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Pola
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Stałe sugestie kierowania geograficznego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

LocationNames

Lista nazw lokalizacji.

Zapis JSON
{
  "names": [
    string
  ]
}
Pola
names[]

string

Lista nazw lokalizacji.

GeoTargets

Lista nazw stałych zasobów w kierowaniu geograficznym.

Zapis JSON
{
  "geoTargetConstants": [
    string
  ]
}
Pola
geoTargetConstants[]

string

Lista nazw stałych zasobów w kierowaniu geograficznym.

GeoTargetConstantSuggestion

Stała sugestia dotycząca kierowania geograficznego.

Zapis JSON
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Pola
geoTargetConstant

object (GeoTargetConstant)

Wynik GeoTargetConstant.

geoTargetConstantParents[]

object (GeoTargetConstant)

Lista elementów nadrzędnych stałej kierowania geograficznego.

locale

string

Język, na który obecnie jest przetłumaczony element GeoTargetConstantsuggestion. Określa ona nazwę pól kierowania geograficznego. Na przykład jeśli locale=pl, to nazwa=Hiszpania. Jeśli locale=es, należy użyć parametru name=España. Jeśli dla języka w żądaniu nie ma tłumaczenia, zostaną zwrócone ustawienia domyślne.

reach

string (int64 format)

Przybliżona populacja użytkowników, która będzie celem kierowania, zaokrąglona do najbliższej wielokrotności 100.

searchTerm

string

Jeśli żądanie zostało wyszukane według nazwy lokalizacji, jest to nazwa lokalizacji pasująca do kierowania geograficznego.