En esta página se ofrece a los desarrolladores de aplicaciones una descripción general de cómo solucionar problemas relacionados con el uso de las APIs de Google y de Google Cloud.
Fondo
Las APIs de Google son APIs de red proporcionadas por 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 de cliente proporcionadas por Google en sus aplicaciones. Estas bibliotecas implementan una lógica estándar habitual, como la autenticación y la paginación de listas, lo que reduce considerablemente la sobrecarga de desarrollo y los errores comunes.
Para obtener más información, consulta la sección Información sobre las bibliotecas de cliente.
Primeros pasos
Si es la primera vez que usas las APIs de Google, debes seguir los pasos que se indican en la página Empezar para preparar tu aplicación. Primero debes usar el comando curl -v
para enviar solicitudes de prueba a las APIs de Google que quieras usar.
Te permite experimentar con las APIs de Google sin escribir código.
A menudo, puedes resolver muchos problemas antes de empezar a desarrollar la aplicación real.
Para obtener más información, consulta Empezar.
Solucionar problemas con métricas
Las APIs de Google proporcionan métricas de API gratuitas que abarcan aspectos comunes del uso de las APIs, como el número 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 detectar un uso anómalo de las APIs e identificar posibles causas principales. Por ejemplo, un mayor número de errores 400 puede significar que una aplicación actualizada recientemente tiene algunos errores lógicos, o que un mayor tamaño de las solicitudes y respuestas puede provocar que el rendimiento de la aplicación sea más lento.
Para obtener más información, consulta Monitorizar el uso de las APIs.
Solucionar problemas con registros
Por motivos de seguridad y privacidad, las APIs de Google no suelen proporcionar registros de APIs a los desarrolladores de aplicaciones. Recomendamos encarecidamente que los desarrolladores de aplicaciones registren los errores de la API en el lado del cliente. Puedes registrar los errores en un almacenamiento local o en una API de registro remota, como la API de Cloud Logging.
Los registros suelen contener más información sobre los errores que las métricas, como mensajes y detalles de errores. Son extremadamente útiles y, a menudo, necesarios para solucionar errores de la API. Cuando los desarrolladores detectan algún problema con el uso de la API, pueden consultar los registros para encontrar mensajes y detalles de errores, y usar la información para resolverlos o ponerse en contacto 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 contengan información detallada sobre las actividades. Son una fuente de información muy útil para solucionar problemas relacionados con el uso de las APIs de Google Cloud. Por ejemplo, la función de prueba de Controles de 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.
Resolver errores
Si tienes problemas con el uso de las APIs de Google y has encontrado las métricas y los registros correspondientes, puedes seguir la página Errores de la guía de diseño de APIs para resolver los errores.
Por lo general, cada error de la API tiene tres elementos de información: código de error, mensaje de error y detalles del error:
- El código de error permite que las aplicaciones gestionen el error en un nivel superior, como volver a intentar la acción después de errores
503o volver a autenticar a los usuarios después de errores401. El mensaje de error permite a los desarrolladores de aplicaciones entender el error y corregir la lógica de su aplicación.
Los detalles del error contienen información adicional que las aplicaciones pueden usar para gestionar el error automáticamente.
Para obtener más información, consulta la página Errores.