Hay muchas situaciones en las que puedes encontrar errores cuando trabajas con la API de Display & Video 360. Estos podrían estar relacionados con un error en tu código, entradas de usuario no válidas o incluso un problema con la API en sí. Cualquiera sea el motivo, saber cómo solucionar errores es una parte importante del proceso de desarrollo. En esta guía, se proporcionarán algunas prácticas recomendadas para comenzar.
Revisión de los conceptos básicos
- Revisa la guía de requisitos previos. Asegúrate de tener acceso a Display & Video 360 y un proyecto de API configurado correctamente.
- Si tu respuesta contiene errores de HTTP, asegúrate de revisarlos con detenimiento y de que la solicitud se realice a la API y al servicio correctos.
- Revise 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 Configura 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 emita al proyecto de API correcto y que esté autorizado para los permisos 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": ... }
Comprende los errores
Cuando la API encuentra un error, normalmente 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 lo que salió mal. Si no es así, es posible que debas investigar un poco más para averiguar qué significa el error.
Investiga los errores
Consulta la sección sobre errores comunes, en la que se proporcionan detalles de algunos de los errores más frecuentes.
Si el error no se describe en la sección de errores comunes, consulta la documentación de referencia y busca el código de error, el estado y el mensaje.
Si encuentras algún error que no esté documentado, comunícate con nosotros.
Identifica la causa raíz
En este punto, identificaste el error y comprendes lo que significa. De lo contrario, vuelve a comprender los errores o ve a la sección Obtén ayuda si crees que te encontraste con un error en la API que no puedes corregir por tu cuenta.
Antes de poder corregir el error, debes identificar la causa. A menudo, será un error en tu código o 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 este funcione según lo previsto. Como primer paso, considera revisar la sección del código responsable de realizar la solicitud fallida para verificar si hay problemas obvios. En algunos casos, puede ser necesario usar una herramienta de depuración para recorrer el código línea por línea y garantizar 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. Revisa la documentación de la biblioteca que prefieras para obtener más detalles. 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 del parámetro 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 responsables de causar el error, es de esperar que la corrección sea obvia. Sin embargo, si no logras avanzar o no estás seguro de la mejor manera de solucionar el problema, puedes usar la información que recopilaste hasta el momento para obtener ayuda.
Cómo obtener ayuda
Si no puedes resolver un error por tu cuenta, puedes comunicarte con el equipo de asistencia al cliente mediante 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 realizaste para solucionarlo. Incluir la siguiente información útil:
- Registros de solicitud y respuesta 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 específica o sospechas que el problema es específico de un lenguaje, incluye un fragmento pequeño para ilustrar lo que estás haciendo.
- Información adicional, como la versión del entorno de ejecución o del intérprete y la plataforma, que puede ser útil para otras personas que intenten reproducir el problema
Soluciona el problema
Una vez que identificaste la causa del problema y encontraste una solución, es hora de implementar una solución. Siempre que sea posible, prueba la corrección en un entorno controlado (como un socio o un anunciante configurado específicamente para pruebas) con un rango de entradas buenas y malas antes de implementarlas en producción.