Method: advertisers.audit

Faz auditoria em um anunciante. Retorna as contagens de entidades usadas por tipo de recurso no anunciante fornecido. As entidades usadas são contabilizadas nos respectivos limites de recursos. Consulte https://support.google.com/displayvideo/answer/6071450.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v3/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 a 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 do proto de resposta serão preenchidos. Os valores válidos são:

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

É 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

Mensagem de resposta para AdvertisingService.AuditAdvertiser.

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

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 ATIVOS, PAUSADOS e RASCUNHO no 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 ATIVO, PAUSADO e RASCUNHO neste anunciante. Esses pedidos de inserção contam para o limite de 9.999 pedidos de inserção por anunciante.
usedCampaignsCount

string (int64 format)

O número de campanhas ATIVAS e PAUSADAS neste anunciante. Essas campanhas contam para o limite de 9.999 campanhas por anunciante.
channelsCount

string (int64 format)

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

string (int64 format)

O número de canais com segmentação negativa criados por este anunciante. Esses canais segmentados negativamente são contabilizados no limite de cinco canais segmentados negativamente por anunciante.
negativeKeywordListsCount

string (int64 format)

O número de listas de palavras-chave negativas criadas por esse 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 de segmentação individuais dos seguintes tipos de segmentação que foram atribuídos a um item de linha neste anunciante. Essas opções de segmentação individuais contam para o 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, afinidade personalizada e no mercado
  • Origem de inventário
  • Palavra-chave
  • Categoria do app para dispositivos móveis
  • Listas de usuários
  • Segmentação de vídeo
  • Visibilidade
campaignCriteriaCount

string (int64 format)

O número de opções de segmentação individuais dos seguintes tipos de segmentação que foram atribuídos a um item de linha neste anunciante. Essas opções de segmentação individuais contam para o limite de 900.000 opções de segmentação de campanha por anunciante.

Tipos de segmentação qualificados:

  • Posição
  • Navegador
  • Velocidade de conexão
  • Dia e hora
  • Dispositivo e sistema operacional
  • Classificação de conteúdo digital
  • Categorias sensíveis
  • Ambiente
  • Região geográfica, incluindo redes de negócios e proximidade
  • ISP
  • Idioma
  • 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.