Soluciona problemas de uso de la API

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 API de Google son API conectadas en red que proporcionan los servicios de Google. Las aplicaciones pueden acceder a las API de Google a través de JSON HTTP y gRPC desde diferentes entornos. Recomendamos a los desarrolladores usar las bibliotecas cliente que proporciona Google en sus aplicaciones. Estas bibliotecas implementan una lógica estándar común, como la autenticación y la paginación de listas, lo que reduce 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 eres nuevo en las API de Google, debes seguir la página Comenzar a fin de completar los pasos de preparación de tu aplicación. Primero, debes usar el comando curl -v para enviar solicitudes de prueba a las API de Google que deseas usar. Te permite experimentar con las API de Google sin escribir ningún código. A menudo, puedes resolver muchos problemas antes de comenzar a desarrollar aplicaciones reales.

Para obtener más información, consulta Cómo comenzar.

Soluciona problemas mediante métricas

Las API de Google proporcionan métricas gratuitas de la API que abarcan aspectos comunes del uso de la API, incluidos los recuentos de solicitudes, los errores, las latencias y los tamaños de las solicitudes y respuestas. Proporcionan dimensiones detalladas en términos de aplicaciones y ubicaciones. Los desarrolladores pueden descubrir el uso anormal de la API e identificar las posibles causas raíz. Por ejemplo, errores 400 más altos pueden significar que una aplicación actualizada recientemente tiene algunos errores lógicos, o un tamaño de solicitud y respuesta más alto puede causar un rendimiento más bajo de la aplicación.

Para obtener más información, consulta Supervisa el uso de la API.

Soluciona problemas a través de registros

Por motivos de seguridad y privacidad, las API de Google no suelen proporcionar registros de API a los desarrolladores de aplicaciones. Recomendamos a los desarrolladores de aplicaciones que registren errores de API en el cliente. Puedes registrar los errores en un almacenamiento local o en una API de registro remoto, 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, necesarias para solucionar errores de la API. Cuando los desarrolladores advierten cualquier problema con el uso de la 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 servicio 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 excelente fuente de información para solucionar problemas de uso de las API 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 la política.

Para obtener más información, consulta Registros de auditoría de Cloud.

Resuelve 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 resolver los errores.

En general, cada error de la API tiene 3 datos: 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 reintentarlo después de errores 503 o volver a autenticar a los usuarios después de errores 401.
  • El mensaje de error permite a los desarrolladores de la aplicación comprender el error y solucionar su lógica.

  • Los detalles del error contienen información adicional que las aplicaciones pueden usar para controlar el error de manera programática.

Para obtener más información, consulta la página Errores.