Method: advertisers.audit

Audita um anunciante. Retorna as contagens 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/v2/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 que serão retornados. Se nenhuma máscara for especificada, todos os campos no protótipo 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 ATIVO, PAUSADO e RASCUNHO neste anunciante. Esses itens de linha são contabilizados no 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 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 nesse 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 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 neste 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 de segmentação que foram atribuídas a um item de linha neste anunciante. Essas opções de segmentação individuais são contabilizadas no limite de 4500.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 de segmentação que foram atribuídas a um item de linha neste anunciante. Essas opções individuais de segmentação 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
  • 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.