Method: listPlannableLocations

Zwraca listę lokalizacji, które można zaplanować (na przykład kraje).

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

Żądanie HTTP

POST https://googleads.googleapis.com/v15:listPlannableLocations

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista lokalizacji, które można zaplanować.

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

Zapis JSON 
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
Pola
plannableLocations[]

object (PlannableLocation)

Lista lokalizacji dostępnych do zaplanowania. Przykładowe lokalizacje znajdziesz na stronie https://developers.google.com/google-ads/api/reference/data/geotargets.

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.

PlannableLocation

Planowana lokalizacja: kraj, region miejski, prowincja itp.

Zapis JSON 
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
Pola
id

string

Identyfikator lokalizacji.
name

string

Unikalna nazwa lokalizacji w języku angielskim.
parentCountryId

string (int64 format)

Kraj nadrzędny (nie występuje, jeśli lokalizacja jest krajem). Jeśli ten element występuje, zawsze będzie identyfikatorem GeoTargetConstant. Dodatkowe informacje, np. nazwę kraju, są dostarczane przez usługę ReachPlanService.ListPlannableLocations lub GoogleAdsService.Search/SearchStream.
countryCode

string

Kod kraju ISO-3166-1 alfa-2 powiązany z lokalizacją.
locationType

string

Typ lokalizacji. Typy lokalizacji odpowiadają typowi targetType zwracanemu przez wyszukiwanie typu lokalizacji w usłudze GoogleAdsService.Search/SearchStream.