Errores y advertencias

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

Errores de la API

Las solicitudes a la API que no se pueden completar muestran un mensaje de error. Las solicitudes que muestran errores se consideran en la cuota del usuario y se tendrán en consideración cuando se revisen las solicitudes de cuota adicional. Las respuestas de error deben procesarse y controlarse para evitar errores futuros.

Una respuesta de error tiene el siguiente formato y, además, incluye un código de respuesta HTTP, un mensaje de error y un estado de código de RPC de Google:

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

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

Código RPC Acción recomendada
400 INVALID_ARGUMENT Hay un problema con tu solicitud. Revisa el campo de mensaje en la respuesta de 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, consulta nuestra guía de introducción.
403 PERMISSION_DENIED No tienes los permisos necesarios para completar tu 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 el tipo de recurso que se recupera sea el correcto.
409 ABORTED El recurso que intentas modificar se está modificando en otro lugar. Espera unos segundos y vuelve a intentar la solicitud.
429 RESOURCE_EXHAUSTED Superaste tu límite de frecuencia o cuota de solicitudes diarias. Examina el uso de tu API con la Consola de API de Google y modifica tu flujo de trabajo para que funcione dentro de los límites de la cuota existentes. Para obtener más información, consulta nuestra página sobre la optimización de cuotas.
500 INTERNAL La API experimentó un error interno. Espera unos segundos y vuelve a intentar 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 que se arrojan durante la generación de SDF se muestran en la tarea de descarga de SDF completada. 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 ve 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 que se puede corregir cuando intentas generar SDF, debes seguir las instrucciones correspondientes. Si el mensaje de error no se puede resolver de forma clara, te recomendamos que realices las siguientes acciones:

  • Verifica que el usuario tenga los permisos adecuados para los recursos del socio o del anunciante superior.
  • Confirma que los IDs proporcionados en el filtro sean precisos, correspondan al tipo de recurso previsto 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 informar el problema.

Advertencias no bloqueantes

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

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

Prevención

Muchos problemas que causan advertencias no bloqueantes se pueden evitar mediante la configuración correcta de los elementos de línea, incluidos los siguientes:

  • Vuelo: Si el vuelo de una línea de pedido no es válido o si venció el vuelo del pedido de inserción superior, la línea de pedido generará una advertencia y no se publicará. Para evitar el último problema, asegúrate de que el período de publicación de una línea de pedido no finalice más tarde que el de su orden de inserción superior.
  • Creatividad asignada: 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 correctamente, es posible que esta genere una advertencia y que la publicación se vea afectada o se impida por completo.

Si replicarás configuraciones de una línea de pedido existente, asegúrate de que esta no genere advertencias imprevistas.

Supervisión

Pueden surgir problemas que generen advertencias no bloqueantes mientras una línea de pedido está en proceso. Para asegurarte de que tus líneas de pedido se publiquen correctamente, supervisa las líneas de pedido activas en busca de advertencias generadas recientemente. Los elementos de una sola línea 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.

Los problemas pueden surgir incluso si no se modificaron la configuración ni la segmentación de una línea de pedido. Entre los ejemplos, se incluyen la detención o el vencimiento del pedido de inserción superior y la baja de las listas de usuarios o de otros segmentaciones.