Method: advertisers.audit

Audita un anunciante. Devuelve los recuentos de 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/v5/advertisers/{advertiserId}:audit

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

Parámetros de ruta

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 de 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, DETENIDAS 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 pedidos de inserción ACTIVOS, PAUSADOS 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 DETENIDAS de este anunciante. Estas campañas se consideran para el límite de 9,999 campañas por anunciante.
channelsCount

string (int64 format)

Es la cantidad de canales creados con este anunciante. Estos canales se incluyen en el límite de 1,000 canales por anunciante.
negativelyTargetedChannelsCount

string (int64 format)

Es la cantidad de canales con segmentación negativa creados para este anunciante. Estos canales con segmentación negativa se tienen en cuenta para el límite de 5 canales con segmentación 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 consideran para 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 consideran para el límite de 4,500,000 opciones de segmentación de grupos de anuncios por anunciante.

Tipos de segmentación que califican:

  • Canales, URLs, apps y colecciones
  • Segmento demográfico
  • Públicos de Google, incluidos los públicos afines, afines personalizados y 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 consideran para el límite de 900,000 opciones de segmentación de la campaña por anunciante.

Tipos de segmentación que califican:

  • 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 empresariales 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.