Method: advertisers.audit

Audita un anunciante. Devuelve los recuentos de las entidades usadas por tipo de recurso en el anunciante proporcionado. Las entidades usadas se consideran en su límite de recursos respectivo. Consulta https://support.google.com/displayvideo/answer/6071450.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
advertiserId

string (int64 format)

Obligatorio. Es el ID del anunciante que se auditará.

Parámetros de consulta

Parámetros
readMask

string (FieldMask format)

Opcional. Son los campos específicos que se devolverán. Si no se especifica ninguna máscara, se completarán todos los campos del proto de respuesta. Estos son los valores válidos:

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

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para AdvertiserService.AuditAdvertiser.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Campos
usedLineItemsCount

string (int64 format)

Es la cantidad de líneas de pedido ACTIVAS, EN PAUSA y EN BORRADOR de este anunciante. Estas líneas de pedido se tienen en cuenta para el límite de 9,999 líneas de pedido por anunciante.
usedInsertionOrdersCount

string (int64 format)

Es la cantidad de órdenes de inserción ACTIVAS, EN PAUSA y EN BORRADOR de este anunciante. Estos pedidos de inserción se tienen en cuenta para el límite de 9,999 pedidos de inserción por anunciante.
usedCampaignsCount

string (int64 format)

Es la cantidad de campañas ACTIVAS y EN PAUSA de este anunciante. Estas campañas se tienen en cuenta para el límite de 9,999 campañas por anunciante.
channelsCount

string (int64 format)

Es la cantidad de canales creados en esta cuenta de anunciante. Estos canales se tienen en cuenta para el límite de 1,000 canales por anunciante.
negativelyTargetedChannelsCount

string (int64 format)

Es la cantidad de canales segmentados de forma negativa creados en esta cuenta de anunciante. Estos canales segmentados de forma negativa se tienen en cuenta para el límite de 5 canales segmentados de forma negativa por anunciante.
negativeKeywordListsCount

string (int64 format)

Es la cantidad de listas de palabras clave negativas creadas para este anunciante. Estas listas de palabras clave negativas se incluyen en el límite de 20 listas de palabras clave negativas por anunciante.
adGroupCriteriaCount

string (int64 format)

Es la cantidad de opciones de segmentación individuales de los siguientes tipos de segmentación que se asignan a una línea de pedido de este anunciante. Estas opciones de segmentación individuales se incluyen en el límite de 4,500,000 opciones de segmentación de grupo de anuncios por anunciante.

Tipos de segmentación aptos:

  • Canales, URLs, apps y colecciones
  • Segmento demográfico
  • Públicos de Google, incluidos los públicos afines, los públicos afines personalizados y los públicos en el mercado
  • Fuente del inventario
  • Palabra clave
  • Mobile app category
  • Listas de usuarios
  • Orientación por video
  • Visibilidad
campaignCriteriaCount

string (int64 format)

Es la cantidad de opciones de segmentación individuales de los siguientes tipos de segmentación que se asignan a una línea de pedido de este anunciante. Estas opciones de segmentación individuales se incluyen en el límite de 900,000 opciones de segmentación de la campaña por anunciante.

Tipos de segmentación aptos:

  • Posición
  • Navegador
  • Velocidad de conexión
  • Día y hora
  • Dispositivo y sistema operativo
  • Etiqueta de contenido digital
  • Categorías sensibles
  • Entorno
  • Ubicación geográfica, incluidas las cadenas de negocios y la proximidad
  • ISP
  • Idioma
  • Verificación de terceros

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.