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/v15/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, zwracane dane geograficzne są tłumaczone z użyciem tego języka. Jeśli nie, domyślnie używane jest en. Jest to też wskazówka w przypadku zwróconych lokalizacji geograficznych.
countryCode

string

Zwrócone lokalizacje geograficzne są ograniczone do tego kodu kraju.
Pole sumy query. To pole jest wymagane. Selektor stałych kierowania geograficznego. query może mieć tylko jedną z tych wartości:
locationNames

object (LocationNames)

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

object (GeoTargets)

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

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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 artykule Omówienie 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 kierowania geograficznego.

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

string

Lista nazw stałych zasobów kierowania geograficznego.

GeoTargetConstantSuggestion

Sugestia stałej wartości 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 jest obecnie tłumaczony ten element GeoTargetConstantSuggestion. Ma wpływ na nazwy pól kierowania geograficznego. Na przykład jeśli locale=pl, wpisz nazwę=Hiszpania. Jeśli locale=es, nazwa=España. Jeśli dla języka w żądaniu nie ma tłumaczenia dla danego języka, 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 100.
searchTerm

string

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