En esta página, se proporciona a los desarrolladores de aplicaciones una descripción general de cómo solucionar problemas del uso de las API de Google y Google Cloud.
Antecedentes
Las APIs de Google son APIs conectadas en red que proporcionan los servicios de Google. Aplicaciones pueden acceder a las APIs de Google a través de JSON HTTP y gRPC desde diferentes entornos. Recomendamos a los desarrolladores que usen las bibliotecas cliente que proporciona Google en sus aplicaciones. Estas bibliotecas implementan una lógica de texto de plantilla común, como la autenticación y la paginación de listas, que reducen en gran medida la sobrecarga de desarrollo y los errores comunes.
Para obtener más información, consulta Explicación de las bibliotecas cliente.
Comenzar
Si es la primera vez que usas las APIs de Google, debes seguir la página
Cómo comenzar para completar los
pasos de preparación de tu aplicación. Primero, debes usar el comando curl -v para enviar solicitudes de prueba a las APIs de Google que deseas usar.
Te permite experimentar con las APIs de Google sin escribir ningún código.
A menudo, puedes resolver muchos problemas antes de comenzar el desarrollo real de la aplicación.
Para obtener más información, consulta Cómo comenzar.
Soluciona problemas con métricas
Las APIs de Google ofrecen métricas de API gratuitas que abarcan aspectos comunes del uso de las APIs, incluidos la cantidad de solicitudes, los errores, las latencias y los tamaños de las solicitudes y las respuestas. Proporcionan dimensiones detalladas en términos de aplicaciones y ubicaciones. Los desarrolladores pueden descubrir el uso anormal de la API y detectar posibles causas raíz. Por ejemplo, un error 400 más alto puede significar un error aplicación actualizada tiene algunos errores lógicos, o una solicitud y respuesta más altas puede ralentizar el rendimiento de la aplicación.
Para obtener más información, consulta el uso de API de Monitoring.
Soluciona problemas con registros
Por motivos de seguridad y privacidad, las APIs de Google, por lo general, no proporcionan registros de API a los desarrolladores de aplicaciones. Recomendamos que los desarrolladores de aplicaciones registren Errores de API del lado del cliente. Puedes registrar los errores en un almacenamiento local o a una API de registro remoto, como la API de Cloud Logging.
Los registros suelen contener más información sobre los errores que las métricas, como y los detalles de los errores. Son muy útiles y, a menudo, necesarios para solucionar problemas de la API. Cuando los desarrolladores detectan algún problema con el uso de su API, pueden consultar los registros para encontrar mensajes de error y detalles, y usar la información para resolver los errores o comunicarse con el equipo de asistencia.
Registros de auditoría de Cloud
Para actividades sensibles de seguridad, los productos de Google Cloud pueden generar registros que contienen información detallada de las actividades. Son una gran fuente de información para solucionar problemas relacionados con el uso de las APIs de Google Cloud. Por ejemplo, la función de ejecución de prueba de los Controles del servicio de VPC genera registros de auditoría para que los administradores evalúen los próximos cambios en las políticas.
Para obtener más información, consulta Registros de auditoría de Cloud.
Cómo resolver errores
Si tienes problemas con el uso de la API de Google y encontraste las métricas y los registros correspondientes, puedes seguir la página Errores de la Guía de diseño de API para resolverlos.
En general, cada error de API tiene 3 datos de información: código de error, mensaje de error y detalles del error:
- El código de error permite que las aplicaciones manejen el error en el nivel superior, como volver a intentarlo después de errores de
503o volver a autenticar a los usuarios después de errores de401. El mensaje de error permite que los desarrolladores de aplicaciones comprendan el error y corrigieron la lógica de la aplicación.
Los detalles del error contienen información adicional que las aplicaciones pueden usar para manejar el error de forma programática.
Para obtener más información, consulta la página Errores.