Hay muchas situaciones en las que puedes encontrar errores cuando trabajas con la API de Display & Video 360. Estos pueden estar relacionados con un error en tu código, una entrada del usuario no válida o incluso un problema con la API en sí. Independientemente del motivo, saber cómo solucionar errores es una parte importante del proceso de desarrollo. En esta guía, se proporcionan algunas sugerencias de prácticas recomendadas para comenzar.
Revisa los conceptos básicos
- Revisa la guía de requisitos. Asegúrate de tener acceso a Display & Video 360 y un proyecto de API configurado correctamente.
- Si la respuesta contiene errores HTTP, asegúrate de revisarlos cuidadosamente y de que la solicitud se realice a la API y al servicio correctos.
- Revisa la guía de autorización. Asegúrate de que tu solicitud contenga las credenciales de OAuth 2.0 necesarias.
Verifica que estés usando las credenciales correctas. Consulta la guía para configurar tu aplicación para obtener detalles sobre cómo generar credenciales de autenticación. También puedes pasar tu token de acceso al extremo tokeninfo de la API de Google OAuth2 para verificar que se haya emitido al proyecto de API correcto y que esté autorizado para los alcances correctos:
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN} 200 OK { "issued_to": "{API_PROJECT_CLIENT_ID}", "audience": "...", "scope": "{API_SCOPES}", "expires_in": ... }
Información sobre los errores
Cuando la API encuentra un error, por lo general, muestra una respuesta JSON que contiene un objeto error. Este objeto proporciona contexto adicional sobre el error específico que se encontró.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
Por lo general, el contenido del objeto error contendrá suficiente información para ayudarte a identificar qué salió mal. De lo contrario, es posible que debas investigar un poco más para descubrir qué significa el error.
Cómo investigar errores
Consulta la sección sobre errores comunes, que proporciona detalles sobre algunos de los errores más frecuentes.
Si el error no se incluye en la sección de errores comunes, consulta la documentación de referencia y busca el código, el estado y el mensaje de error.
Si encuentras algún error que no esté documentado, avísanos.
Identifica la causa raíz
En este punto, ya identificaste el error y sabes qué significa. De lo contrario, vuelve a comprender los errores o avanza a obtener ayuda si crees que encontraste un error en la API que no puedes corregir por tu cuenta.
Antes de corregir el error, deberás identificar qué lo causa. A menudo, esto se debe a un error en el código o a un valor de entrada no válido.
Para determinar si el problema está relacionado con un error en tu código, primero debes verificar que funcione según lo previsto. Como primer paso, considera revisar la sección de código responsable de realizar la solicitud con errores para verificar si hay problemas obvios. En algunos casos, es posible que debas usar una herramienta de depuración para revisar el código línea por línea y asegurarte de que funcione correctamente.
Examinar las solicitudes HTTP es otra forma útil de identificar posibles errores, así como casos de entradas no válidas. Muchas de las bibliotecas cliente oficiales se pueden configurar para registrar solicitudes y respuestas HTTP. Para obtener más detalles, consulta la documentación de la biblioteca que elijas. También se puede usar un proxy HTTP, como Charles, Squid o Fiddler, para capturar registros de solicitudes y respuestas. Una vez que obtengas estos registros, revísalos para asegurarte de que los valores de los parámetros de solicitud que proporciona tu aplicación sean correctos y coincidan con lo que esperas.
Una vez que identifiques el error o la entrada no válida que lo causa, espero que la solución sea obvia. Sin embargo, si no puedes avanzar o no sabes cómo solucionar el problema, puedes usar la información que recopilaste hasta el momento cuando busques ayuda.
Cómo obtener ayuda
Si no puedes resolver un error por tu cuenta, puedes comunicarte con nuestro equipo de asistencia a través de este formulario, que se encuentra en el Centro de ayuda de Display & Video 360.
Cuando completes este formulario, debes incluir la mayor cantidad de información posible sobre el problema que tienes y los pasos que ya seguiste para solucionarlo. Información útil que debes incluir:
- Registros de solicitudes y respuestas HTTP Asegúrate de ocultar la información sensible, como los tokens de acceso de OAuth 2.0, las direcciones de correo electrónico, etcétera.
- Fragmento de código. Si puedes aislar el problema en una sección de código en particular o sospechas que es específico del idioma, incluye un pequeño fragmento para ilustrar lo que estás haciendo.
- Información adicional, como la versión y la plataforma del entorno de ejecución o del intérprete, que puede ser útil para otras personas que intenten reproducir el problema
Soluciona el problema
Una vez que hayas identificado la causa del problema y hayas encontrado una solución, es hora de implementar una corrección. Siempre que sea posible, prueba la corrección en un entorno controlado (como un socio o anunciante configurado específicamente para pruebas) con una variedad de entradas buenas y malas antes de implementarla en producción.