Method: listPlannableProducts

Retorna a lista de formatos de anúncio do YouTube que podem ser planejados por local com segmentação permitida.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

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

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "plannableLocationId": string
}
Campos
plannableLocationId

string

Obrigatório. ID do local selecionado para planejamento. Para listar os IDs de local planejados disponíveis, use ReachPlanService.ListPlannableLocations.

Corpo da resposta

Uma resposta com todos os produtos disponíveis.

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

Representação JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Campos
productMetadata[]

object (ProductMetadata)

É a lista de produtos disponíveis para metadados de segmentação e planejamento.

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.

ProductMetadata

Os metadados associados a um produto planável disponível.

Representação JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Campos
plannableProductName

string

O nome associado ao produto de publicidade.
plannableTargeting

object (PlannableTargeting)

A segmentação planável permitida para este produto.
plannableProductCode

string

O código associado ao produto de anúncio (por exemplo: BUMPER, TRUEVIEW_IN_STREAM). Para listar os códigos de produtos planejados disponíveis, use ReachPlanService.ListPlannableProducts.

PlannableTargeting

A segmentação em que as métricas de tráfego vão ser informadas.

Representação JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Campos
ageRanges[]

enum (ReachPlanAgeRange)

Faixas etárias planejadas permitidas para o produto em que as métricas serão informadas. A segmentação real é calculada pelo mapeamento dessa faixa etária em valores comuns.AgeRangeInfo padrão do Google.
genders[]

object (GenderInfo)

Gêneros segmentáveis para o produto de anúncio.
devices[]

object (DeviceInfo)

São os dispositivos segmentáveis para o produto de publicidade. A segmentação por dispositivo TABLET é aplicada automaticamente às métricas informadas quando a segmentação por DISPOSITIVOS MÓVEIS é selecionada para os produtos CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER e GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Redes segmentáveis para o produto de publicidade.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Lineups do YouTube Select segmentáveis para o produto de anúncio.
surfaceTargeting

object (SurfaceTargetingCombinations)

Combinações de plataformas segmentáveis para o produto do anúncio.

YouTubeSelectLineUp

Um lineup planável do YouTube Select para segmentação de produtos.

Representação JSON 
{
  "lineupId": string,
  "lineupName": string
}
Campos
lineupId

string (int64 format)

O ID do lineup do YouTube Select.
lineupName

string

O nome exclusivo do lineup do YouTube Select.

SurfaceTargetingCombinations

São as combinações de plataformas disponíveis para um produto de publicidade.

Representação JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Campos
defaultTargeting

object (SurfaceTargeting)

Segmentação de superfície padrão aplicada ao produto de anúncio.
availableTargetingCombinations[]

object (SurfaceTargeting)

Combinações de plataformas de destino disponíveis para o produto de publicidade.