Method: advertisers.audit

Faz auditorias em um anunciante. Retorna a contagem de entidades usadas por tipo de recurso no anunciante fornecido. As entidades usadas contam para o limite de recursos delas. 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 no 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 AdvertiserService.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 ATIVADOS, PAUSADOS e EM Rascunho desse anunciante. Esses itens de linha contam para o limite de 9.999 itens por anunciante.
usedInsertionOrdersCount

string (int64 format)

O número de pedidos de inserção ATIVA, PAUSADA e Rascunho para esse anunciante. Esses pedidos de inserção contam para o limite de 9.999 pedidos por anunciante.
usedCampaignsCount

string (int64 format)

O número de campanhas ATIVAS e PAUSADAS desse 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 esse 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 para 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 individual dos seguintes tipos de segmentação atribuídos a um item de linha desse 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 individual dos seguintes tipos de segmentação atribuídos a um item de linha desse anunciante. Essas opções individuais contam para o limite de 900.000 opções de segmentação por 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
  • Local geográfico, 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.