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. Las 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 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 las métricas
Las APIs de Google proporcionan métricas de API gratuitas que abarcan aspectos comunes del uso de las APIs, como los recuentos de solicitudes, los errores, las latencias, 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, luego, identificar posibles causas raíz. Por ejemplo, los errores 400 más altos pueden significar que una aplicación actualizada recientemente tiene algunos errores lógicos, o que los tamaños de solicitud y respuesta más altos pueden ralentizar el rendimiento de la aplicación.
Para obtener más información, consulta el uso de API de Monitoring.
Cómo solucionar problemas con los 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 los errores de la API en el cliente. Puedes registrar los errores en un almacenamiento local o en una API de registro remota, como la API de Cloud Logging.
Por lo general, los registros contienen más información sobre los errores que las métricas, como los mensajes de error y los detalles de los errores. Son muy útiles y, a menudo, necesarios para solucionar errores 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
En el caso de las actividades sensibles a la seguridad, los productos de Google Cloud pueden generar registros de auditoría 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 de política.
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 APIs 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 controlar el error de forma programática.
Para obtener más información, consulta la página Errores.