Method: listPlannableProducts

Retorna a lista de formatos de anúncios do YouTube programáveis por local com segmentação permitida.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v16: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. O ID do local selecionado para planejamento. Para listar os IDs de local disponíveis para planejamento, 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 planejamento e metadados de segmentação relacionados.

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 planificável disponível.

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

string

O nome associado ao produto de anúncio.
plannableTargeting

object (PlannableTargeting)

A segmentação programá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 produto planificáveis disponíveis, use ReachPlanService.ListPlannableProducts.

PlannableTargeting

A segmentação sobre a qual as métricas de tráfego serão 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 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)

Dispositivos segmentáveis para o produto de anúncio. A segmentação por dispositivo TABLET é aplicada automaticamente às métricas informadas quando a segmentação por DISPOSITIVO MÓVEL é selecionada para os produtos CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER e GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

Redes segmentáveis para o produto de anúncio.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Lineups do YouTube Select segmentáveis para o produto de publicidade.
surfaceTargeting

object (SurfaceTargetingCombinations)

Combinações de superfícies segmentáveis para o produto de anúncio.

YouTubeSelectLineUp

Um lineup 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

As combinações de segmentação por superfície 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 segmentações de superfície disponíveis para o produto de anúncio.