Method: advertisers.audit

Audita um anunciante. Retorna o número de entidades usadas por tipo de recurso no anunciante fornecido. As entidades usadas são contabilizadas no respectivo limite de recursos. Consulte https://support.google.com/displayvideo/answer/6071450.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}:audit

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

Parâmetros de caminho

Parâmetros
advertiserId

string (int64 format)

Obrigatório. O ID do anunciante que será auditado.

Parâmetros de consulta

Parâmetros
readMask

string (FieldMask format)

Opcional. Os campos específicos a serem retornados. Se nenhuma máscara for especificada, todos os campos no proto de resposta serão preenchidos. Os valores válidos são:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

Esta é uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Mensagem de resposta para AdvertiserService.AuditAdvertiser.

Representação JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Campos
usedLineItemsCount

string (int64 format)

O número de itens de linha ATIVO, PAUSADO e RASCUNHO neste anunciante. Esses itens de linha contam para o limite de 9.999 itens de linha por anunciante.
usedInsertionOrdersCount

string (int64 format)

É o número de pedidos de inserção ACTIVE, PAUSADO e RASCUNHO neste anunciante. Esses pedidos de inserção são contabilizados no limite de 9.999 pedidos de inserção por anunciante.
usedCampaignsCount

string (int64 format)

O número de campanhas ATIVAS e PAUSADAS desse anunciante. Essas campanhas são contabilizadas no limite de 9.999 campanhas por anunciante.
channelsCount

string (int64 format)

O número de canais criados neste anunciante. Esses canais contam para o limite de 1.000 canais por anunciante.
negativelyTargetedChannelsCount

string (int64 format)

O número de canais com segmentação negativa criados neste anunciante. Esses canais com segmentação negativa são contabilizados no limite de cinco canais desse tipo por anunciante.
negativeKeywordListsCount

string (int64 format)

O número de listas de palavras-chave negativas criadas nesse anunciante. Essas listas são contabilizadas no limite de 20 listas de palavras-chave negativas por anunciante.
adGroupCriteriaCount

string (int64 format)

É o número de opções individuais de segmentação dos seguintes tipos que estão atribuídos a um item de linha no anunciante. Essas opções individuais são contabilizadas no limite de 4.500.000 opções de segmentação de grupo de anúncios por anunciante.

Tipos de segmentação qualificados:

  • Canais, URLs, apps e coleções
  • Informações demográficas
  • Públicos-alvo do Google, incluindo públicos-alvo de afinidade, de afinidade personalizada e no mercado
  • Fonte de inventário
  • Palavra-chave
  • Mobile app category
  • Listas de usuários
  • Segmentação de vídeo
  • Visibilidade
campaignCriteriaCount

string (int64 format)

É o número de opções individuais de segmentação dos seguintes tipos que estão atribuídos a um item de linha no anunciante. Essas opções individuais são contabilizadas no limite de 900.000 opções de segmentação de campanha por anunciante.

Tipos de segmentação qualificados:

  • Cargo
  • Navegador
  • Velocidade de conexão
  • Dia e hora
  • Dispositivo e sistema operacional
  • Classificação de conteúdo digital
  • Categorias sensíveis
  • Ambiente
  • Localização geográfica, incluindo redes de negócios e proximidade
  • ISP
  • linguagem
  • Verificação com terceiros

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/display-video

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