Method: advertisers.audit

Audita a un anunciante. Muestra los recuentos de entidades usadas por tipo de recurso según el anunciante proporcionado. Las entidades usadas se tienen en cuenta para sus respectivos límites de recursos. 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. Los campos específicos que se mostrarán. Si no se especifica una máscara, se completarán todos los campos del protocolo 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

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, DETENIDAS y BORRADORES 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)

La cantidad de pedidos de inserción ACTIVOS, DETENIDOS y BORRADORES 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 tienen en cuenta para el límite de 9,999 campañas por anunciante.

channelsCount

string (int64 format)

La cantidad de canales creados para este anunciante. Estos canales se consideran para el límite de 1,000 canales por anunciante.

negativelyTargetedChannelsCount

string (int64 format)

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 por anunciante.

negativeKeywordListsCount

string (int64 format)

La cantidad de listas de palabras clave negativas creadas para este anunciante. Estas listas de palabras clave negativas se tienen en cuenta 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 tienen en cuenta para el límite de 4,500,000 de 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, 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 tienen en cuenta para el límite de 900,000 opciones de segmentación de campaña por anunciante.

Tipos de segmentación aptos:

  • Posición
  • Navegador
  • Velocidad de la 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 comerciales y su proximidad
  • ISP
  • Idioma
  • Verificación de terceros

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.