Errores y advertencias

En esta página, se analizan los diferentes tipos de errores y advertencias que pueden surgir cuando usas la API de Display & Video 360.

Errores de API

Las solicitudes que se realizan a la API y que no se pueden completar muestran un mensaje de error. Las solicitudes que muestran errores se descuentan de la cuota de usuarios y se tendrán en cuenta cuando se revisen las solicitudes de cuota adicional. Las respuestas de error deben procesarse y manejarse para evitar errores futuros.

Una respuesta de error toma el siguiente formato e incluye un código de respuesta HTTP, un mensaje de error y el estado de un código RPC de Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

A continuación, se muestra una lista de errores comunes de API junto con la acción recomendada que se debe realizar si se muestran:

Código RPC Acción recomendada
400 INVALID_ARGUMENT Se produjo un error con tu solicitud. Revisa el campo de mensaje en la respuesta del error y modifica tu solicitud según corresponda.
401 UNAUTHENTICATED No se pudo autenticar correctamente tu solicitud. Verifica que incluyas credenciales de OAuth válidas en tu solicitud. Para obtener más información sobre este tema, consulta nuestra guía de introducción.
403 PERMISSION_DENIED No tienes los permisos necesarios para completar la solicitud. Verifica que tu cuenta de usuario tenga los permisos adecuados para el socio o anunciante relevante.
404 NOT_FOUND No se puede encontrar el recurso que intentas recuperar. Verifica que el ID que usas sea correcto y que coincida con el tipo de recurso que se recupera.
409 ABORTED El recurso que intentas modificar se está modificando en otro lugar. Espera unos segundos y vuelve a enviar la solicitud.
429 RESOURCE_EXHAUSTED Superaste tu límite de frecuencia o cuota de solicitudes diarias. Examina el uso de la API con la Consola de API de Google y modifica tu flujo de trabajo para operar dentro de los límites de cuota existentes. Si deseas obtener más información, consulta nuestra página sobre optimización de cuotas.

Si tus operaciones no se pueden completar con la cuota diaria determinada, puedes solicitar una cuota adicional.
500 INTERNAL Se produjo un error interno en la API. Espera unos segundos y vuelve a enviar la solicitud. Si el error persiste, comunícate con el equipo de asistencia.
504 DEADLINE_EXCEEDED La API tardó demasiado en completar la solicitud. Espera unos segundos y vuelve a enviar la solicitud. Si el error persiste, comunícate con el equipo de asistencia.

Errores de SDF

La API de Display & Video 360 usa un método asíncrono para generar y descargar archivos de datos estructurados (SDF). Por este motivo, los errores arrojados durante la generación del SDF se muestran en la tarea de descarga del SDF finalizada. Una tarea de descarga de SDF que finaliza en error se marca como completada, pero tiene un campo de error propagado en lugar de un nombre de recurso multimedia en el campo response, como se muestra en este ejemplo truncado:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Si recibes un mensaje de error práctico cuando intentas generar SDF, debes seguirlo según corresponda. Si el mensaje de error no es claramente útil, te recomendamos que realices las siguientes acciones:

  • Verifica que el usuario tenga los permisos adecuados para los recursos superiores de socio o anunciante.
  • Confirma que los ID proporcionados en el filtro sean correctos, correspondan al tipo de recurso deseado y estén dentro del contexto del ID raíz determinado.
  • Asegúrate de no exceder el límite de veinte tareas de descarga de SDF simultáneas por usuario.

Si los errores persisten, comunícate con el equipo de asistencia para informarlo.

Advertencias sin bloqueo

Se asignan advertencias sin bloqueo a las líneas de pedido para indicar un problema que puede afectar su publicación. Las advertencias similares se comunican en la IU a través de un banner de notificación. Estas advertencias son pasivas y aparecen en el campo warningMessages de una línea de pedido.

Aunque son pasivos, los problemas que causan estas advertencias pueden afectar la publicación de una línea de pedido hasta el punto de evitarla por completo.

Prevención

Muchos problemas que causan advertencias sin bloqueo se pueden evitar mediante la configuración adecuada de los ajustes de la línea de pedido, incluidos los siguientes:

  • Período de publicación: Si el vuelo de una línea de pedido no es válido o si el período de publicación del pedido de inserción superior venció, la línea de pedido generará una advertencia y no se publicará. Para evitar este último problema, asegúrate de que el período de publicación de una línea de pedido no finalice después del período de publicación de su pedido de inserción superior.
  • Creatividades asignadas: Si no hay una creatividad válida asignada a una línea de pedido, esta generará una advertencia y no se publicará.
  • Segmentación: Si la segmentación de una línea de pedido no se asigna de forma correcta, es posible que la línea de pedido genere una advertencia y que se vea afectada o se evite por completo.

Si estás replicando los parámetros de configuración de una línea de pedido existente, asegúrate de que esta no genere ninguna advertencia inesperada.

Supervisión

Mientras una línea de pedido está en tránsito, pueden surgir problemas que causan advertencias sin bloqueo. Para asegurarte de que tus líneas de pedido se publiquen correctamente, supervisa las líneas de pedido activas en busca de advertencias recién generadas. Las líneas de pedido se pueden recuperar de forma masiva con la función advertisers.lineItems.list. Si una línea de pedido genera una advertencia inesperada, debes abordar el problema de inmediato para reducir el impacto en la publicación.

Pueden surgir problemas incluso si la configuración o la segmentación de una línea de pedido no cambiaron. Algunos ejemplos incluyen la detención o el vencimiento del pedido de inserción superior y la baja de las listas de usuarios o de otros tipos de segmentación.