Method: listPlannableLocations

Retorna a lista de locais planificáveis (por exemplo, países).

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A lista de locais que podem ser planejados.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
Campos
plannableLocations[]

object (PlannableLocation)

É a lista de locais disponíveis para planejamento. Acesse https://developers.google.com/google-ads/api/reference/data/geotargets para ver locais de exemplo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

PlannableLocation

Um local a planejar: país, região metropolitana, província etc.

Representação JSON 
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
Campos
id

string

É o identificador do local.
name

string

O nome exclusivo do local em inglês.
parentCountryId

string (int64 format)

O país pai (não estará presente se o local for um país). Se presente, sempre será um ID GeoTargetConstant. Informações adicionais, como o nome do país, são fornecidas pela ReachPlanService.ListPlannableLocations ou pelo GoogleAdsService.Search/SearchStream.
countryCode

string

O código do país ISO-3166-1 alfa-2 associado ao local.
locationType

string

O tipo de local. Os tipos de local correspondem ao targetType retornado pelo tipo de local em GoogleAdsService.Search/SearchStream.