Errores y advertencias

La API de Display & Video 360 puede responder con varios errores y advertencias. Una solución de API en buen estado debe controlar estos errores.

Errores de la API

Las solicitudes a la API que no realizan la acción prevista muestran un error. Se deben detectar y controlar las respuestas de error.

Una respuesta de error de la API tiene un código de respuesta HTTP, un mensaje de error y un estado de código de RPC de Google. Tiene el siguiente formato:

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

A continuación, se incluye una lista de errores comunes de la API y las acciones recomendadas:

Códigos de error
`400`	`INVALID_ARGUMENT` Hay un problema con tu solicitud. Revisa el campo de mensaje en la respuesta del error y actualiza 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 inicio rápido.
`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 correspondiente.
`404`	`NOT_FOUND` No se puede encontrar el recurso que intentas recuperar. Verifica que el ID que usas sea correcto y corresponda al 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. Usa la consola de Google Cloud para examinar el uso de la API. Actualiza tu flujo de trabajo para que se ejecute dentro de los límites de cuota existentes. Para obtener más información, consulta nuestra guía sobre la optimización del uso.
`500`	`INTERNAL` La API experimentó un error interno. 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 tareas de larga duración para generar archivos de datos estructurados (SDF). Los errores en la creación de los SDF se devuelven en el objeto operation terminado. El campo error contendrá los detalles. Observa este ejemplo truncado:

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

Si el mensaje de error no es claro, te recomendamos que hagas lo siguiente:

Verifica que tu usuario tenga, al menos, el rol de usuario Estándar para el socio o el anunciante principal.
Confirma que los IDs proporcionados en el filtro sean precisos. Los IDs deben corresponder al tipo de recurso previsto y deben ser recursos secundarios del ID raíz.
Asegúrate de que tu usuario tenga menos de veinte tareas de descarga de SDF simultáneas.

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

Advertencias sin bloqueo

Las advertencias que no bloquean el contenido indican un problema que puede afectar la publicación de anuncios de un concepto de línea. En la IU, se ven advertencias similares. Estas advertencias son pasivas y se enumeran en la línea de pedido.

La causa raíz de una advertencia puede afectar la publicación de una línea de pedido. En algunos casos, podría impedir por completo la publicación de anuncios.

Prevención

Algunas advertencias no bloqueantes se deben a la configuración incorrecta de una línea de pedido:

Vuelo: Una línea de pedido no publicará anuncios si su vuelo no es válido o si el vuelo de su pedido de inserción venció. Asegúrate de que una línea de pedido tenga una publicación dentro de la de su orden de inserción.
Creatividades asignadas: No se puede publicar una línea de pedido si no se le asigna una creatividad válida.
Segmentación: Es posible que la publicación de anuncios de una línea de pedido se vea afectada o se impida por completo si su segmentación no se asigna correctamente.

Asegúrate de que una línea de pedido existente no genere ninguna advertencia antes de usar sus configuraciones en una línea de pedido nueva.

Supervisión

Pueden aparecer advertencias no bloqueantes mientras se publica una línea de pedido. Supervisa tus líneas de pedido activas para detectar advertencias nuevas y asegurarte de que se publiquen correctamente. Obtén líneas de pedido de forma masiva con una solicitud list. Si una línea de pedido muestra una advertencia inesperada, soluciona el problema lo antes posible para reducir el impacto en la publicación.

Se pueden agregar advertencias incluso si no se modificaron la configuración ni la segmentación. Estos son algunos ejemplos:

El pedido de inserción está detenido o vence.
Se dejó de usar una lista de usuarios o una opción de segmentación.