Method: advertisers.audit

Audita a un anunciante. Muestra el recuento de entidades utilizadas por tipo de recurso en el anunciante proporcionado. Las entidades utilizadas se consideran en su respectivo límite de recursos. Consulta https://support.google.com/displayvideo/answer/6071450.

Solicitud HTTP

GET https://displayvideo.googleapis.com/v2/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 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

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, PAUSADAS y EN RASTRO 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 ACTIVE, PAUSED y DRAFT 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)

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)

Es la cantidad de canales creados en este 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 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 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 tienen en cuenta para el límite de 4,500,000 opciones de segmentación de grupos 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 incluyen en el límite de 900,000 opciones de segmentación de campañas 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 cadenas de empresas y proximidad
  • ISP
  • Idioma
  • Verificación de terceros

Permisos 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.