Method: listPlannableLocations

Zwraca listę lokalizacji, które można zaplanować (np. krajów).

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

Żądanie HTTP

POST https://googleads.googleapis.com/v16: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, które można zaplanować. 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 omówieniu 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 identyfikator jest używany, zawsze jest identyfikatorem GeoTargetConstant. Dodatkowe informacje, takie jak nazwa kraju, są dostarczane przez ReachPlanService.ListPlannableLocations lub GoogleAdsService.Search/SearchStream.
countryCode

string

Kod kraju w formacie ISO-3166-1 alfa-2, który jest powiązany z lokalizacją.
locationType

string

Typ lokalizacji. Typy lokalizacji odpowiadają wartościom targetType zwracanym przez wyszukiwanie typu lokalizacji w GoogleAdsService.Search/SearchStream.