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 limite de recursos correspondente. Consulte https://support.google.com/displayvideo/answer/6071450.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v5/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 ATIVOS, PAUSADOS e em RASCUNHO desse 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 ATIVOS, PAUSADOS e em RASCUNHO desse 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 desse anunciante. Essas campanhas contam para o limite de 9.999 campanhas por anunciante.
channelsCount

string (int64 format)

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

string (int64 format)

O número de canais segmentados negativamente criados para esse anunciante. Esses canais com segmentação negativa contam para o limite de cinco canais com segmentação negativa por anunciante.
negativeKeywordListsCount

string (int64 format)

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

string (int64 format)

O número de opções de segmentação individuais dos seguintes tipos de segmentação atribuídas a um item de linha desse anunciante. Essas opções de segmentação 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
  • 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 atribuídas a um item de linha desse 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:

  • Posição
  • Navegador
  • Velocidade de conexão
  • Dia e hora
  • Dispositivo e sistema operacional
  • Classificação de conteúdo digital
  • Categorias sensíveis
  • Ambiente
  • Geografia, incluindo franquias 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 OAuth 2.0 Overview.