Errores y advertencias

Esta página analiza los diferentes tipos de errores y advertencias que puedes que encontrarás cuando uses la campaña API de Video 360.

Errores de API

Las solicitudes realizadas a la API que no se pueden completar muestran un mensaje de error. Las solicitudes que muestran errores se descuentan de la cuota del usuario y se analizarán al revisar las solicitudes de cuota adicional. Respuestas de error se deben procesar y manejar 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 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 para si se devuelven:

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 la solicitud. Verifica que incluyas OAuth válido credenciales en tu solicitud. 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.
404 NOT_FOUND El recurso que intentas recuperar no se puede que los demás usuarios puedan encontrar. Verifica que el ID que usas sea correcto y para el tipo de recurso que se recupera.
409 ABORTED El recurso que intentas modificar se está volviendo modificados en otro lugar. Espera unos segundos y, luego, reintentar la solicitud.
429 RESOURCE_EXHAUSTED Superaste tus límite de frecuencia o cuota de solicitudes diarias. Examina tu uso de la API con el Consola de APIs de Google y modificar tu flujo de trabajo para operar dentro de la cuota existente límites. Para obtener más información, consulta nuestra página en Optimización de cuotas.

Si tus operaciones no se pueden completar dentro del según la cuota diaria, solicitar una cuota adicional.

500 INTERNAL Se produjo un error interno en la API. Espera unos minutos segundos y vuelve a intentar la solicitud. Si el error si 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 pantalla y La API de Video 360 usa un método asíncrono para generar y descargar archivos de datos estructurados (SDF). Para este por lo que los errores arrojados durante la generación del SDF se muestran en el SDF finalizado. tarea de descarga. Una tarea de descarga de SDF que finaliza en error es está marcado como listo, pero tiene un campo de error propagado en lugar del nombre de un recurso de medios 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 procesable cuando intentas generar SDF, puedes debe seguirla en consecuencia. Si el mensaje de error no es claramente procesable, recomienda las siguientes acciones:

  • Verifica que tu usuario tenga los permisos adecuados para el elemento superior recursos de socios o anunciantes.
  • Confirma que los IDs proporcionados en filter sean correctos. corresponden al tipo de recurso previsto y se encuentran dentro del contexto del dado el ID raíz.
  • Asegúrate de no exceder el límite de veinte descargas de SDF simultáneas tareas por usuario.

Si los errores persisten, comunícate con el equipo de asistencia para informar tu problema.

Advertencias sin bloqueo

Se asignan advertencias que no generan bloqueo a las líneas de pedido para indicar que puede afectar la publicación de una línea de pedido. Se comunican advertencias similares en la IU a través de un banner de notificación. Estas advertencias son pasivas y son 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 de la línea de pedido hasta el punto de evitarla por completo.

Prevención

Muchos problemas que causan advertencias que no generan bloqueo se pueden evitar con de la línea de pedido, incluidos los siguientes:

  • Publicación: Si el período de publicación de una línea de pedido no es válido o si venció el período de publicación del pedido de inserción principal, la línea de pedido generará un y no se publicará. Para evitar este último problema, asegúrate de que una línea el período de publicación del artículo no termina después del período de publicación de su inserción principal en el orden personalizado.
  • Creatividades asignadas: Cuando no hay una creatividad válida. se asigna a una línea de pedido, esta generará una advertencia y publicar anuncios.
  • Segmentación: Si la segmentación de una línea de pedido no es la misma correctamente asignada, la línea de pedido podría generar una advertencia y afecta o evita por completo.

Si replica la configuración desde una línea de pedido existente, La línea de pedido existente no genera advertencias imprevistas.

Supervisión

Pueden surgir problemas que causan advertencias que no generan bloqueo cuando una línea de pedido está en vuelo. Para asegurarse de que sus líneas de pedido se publiquen correctamente, supervise las líneas de pedido activas para las advertencias nuevas. 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 solucionar el problema 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. Entre los ejemplos, se incluyen la detención o el vencimiento del pedido de inserción principal y el ya que las listas de usuarios y otros tipos de segmentación dejarán de estar disponibles.