Aunque puedes usar las APIs directamente enviando solicitudes sin formato al servidor, las bibliotecas de cliente ofrecen simplificaciones que reducen significativamente la cantidad de código que tienes que escribir. Google Cloud
En este documento se explican los métodos para interactuar con las APIs de Google Cloud :
- Bibliotecas de cliente de Cloud (opción recomendada)
- Bibliotecas de cliente de APIs de Google
- Firebase Mobile
- Tu propio código de cliente
Para encontrar información sobre la biblioteca de cliente de un Google Cloud producto concreto, consulta la sección de bibliotecas de cliente de la documentación de ese producto. Para ver todas las bibliotecas de cliente de Cloud, que suelen estar organizadas por lenguaje admitido, consulta Bibliotecas de cliente de Cloud.
Bibliotecas de cliente de Cloud
Las bibliotecas de cliente de Cloud son la opción recomendada para acceder a las APIs de Cloud de forma programática, cuando estén disponibles. Las bibliotecas de cliente de Cloud usan el modelo de biblioteca de cliente más reciente y:
- Proporciona código idiomático en cada idioma para que las APIs sean intuitivas. Google Cloud
- Proporcionar un estilo coherente en todas las bibliotecas de cliente para simplificar el trabajo con varios servicios Google Cloud .
- Gestionan todos los detalles de bajo nivel de la comunicación con el servidor, incluida la autenticación con Google.
- Se puede instalar con herramientas de gestión de paquetes habituales, como
npmypip. - En algunos casos, te ofrece ventajas de rendimiento al usar gRPC. Para obtener más información, consulta APIs gRPC.
Las instrucciones de instalación y los materiales de referencia de las bibliotecas de cliente de Cloud dependen de la Google Cloud API y del lenguaje de programación que utilices. Para encontrar esta información, consulta la documentación del Google Cloud producto específico. La mayoría de los productos incluyen una sección "Bibliotecas de cliente" en su documentación, que proporciona instrucciones específicas para cada lenguaje, pasos de instalación y enlaces a la referencia detallada de la API.
Para consultar la documentación de un producto específico, puedes buscar en la Google Cloud biblioteca de APIs.
Pruébalo
Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.
Empezar gratisBibliotecas de cliente de APIs de Google
Si las bibliotecas de cliente de Cloud no están disponibles en el lenguaje que prefieres para una API específica, puedes usar las bibliotecas de cliente de las APIs de Google. Se trata de un tipo de biblioteca de cliente anterior proporcionado por Google.
También puedes usar estas bibliotecas si vas a actualizar un proyecto que ya las utiliza. Estas bibliotecas:
- Proporciona acceso solo a la interfaz REST de la API. No se admite gRPC.
- Tienen código de interfaz generado automáticamente que puede que no sea tan idiomático como las bibliotecas cliente de Cloud.
- Gestionan todos los detalles de bajo nivel de la comunicación con el servidor, incluida la autenticación con Google.
- Se puede instalar con herramientas de gestión de paquetes habituales, como
npmypip.
Usar la plataforma móvil de Firebase
Firebase es la solución de Google para crear aplicaciones en dispositivos móviles. Ofrece un SDK con código de cliente que te permite acceder a APIs relevantes para móviles desde aplicaciones iOS, Android y web. Google Cloud Para obtener información sobre las APIs compatibles y cómo empezar a usar Firebase, consulta la documentación de Firebase. Google Cloud
Uso del propio código de cliente
Si eres un desarrollador con experiencia y las bibliotecas de cliente de Cloud no satisfacen tus necesidades específicas, puedes escribir tu propio código personalizado para acceder directamente a las APIs de servicio de nivel inferior del servicio.
APIs REST/HTTP
Todas las APIs de Google Cloud exponen una interfaz JSON/REST. Si necesitas escribir tu propio código personalizado para acceder directamente a la API REST mediante una biblioteca de cliente HTTP de terceros, puedes consultar más información sobre cómo funcionan las APIs con diferentes versiones e implementaciones de HTTP en las directrices de HTTP. Google Cloud
APIs de gRPC
gRPC es un sistema de llamadas a procedimientos remotos (RPC) de código abierto, independiente del lenguaje y de la plataforma, que se desarrolló inicialmente en Google. Puedes obtener más información en grpc.io. Las APIs Google Cloud compatibles con gRPC suelen tener interfaces REST y RPC, por lo que, en lugar de usar solo JSON a través de HTTP para comunicarse con la interfaz REST, los clientes de APIs compatibles con gRPC también pueden usar búferes de protocolo y gRPC a través de HTTP2 para comunicarse con la interfaz RPC. Para saber si una API es compatible con gRPC, consulta su sección APIs and Reference (APIs y referencia).
Si una API tiene habilitado gRPC, puedes generar tus propias bibliotecas de cliente de gRPC en cualquier lenguaje compatible con gRPC. Google Cloud Para ello, necesitarás la definición de servicio de búferes de protocolo de la API (normalmente disponible en el repositorio de GitHub).
A continuación, puedes seguir las instrucciones del idioma que prefieras en grpc.io para generar y usar tu cliente.
Si no quieres generar tu propio código gRPC, puedes aprovechar las ventajas de gRPC: cada vez más bibliotecas de cliente de Cloud para APIs habilitadas para gRPC usan gRPC "bajo el capó" para comunicarse con los servidores de Google. Es mucho más eficiente en términos de rendimiento y uso de la CPU: acceder a una API mediante gRPC puede aumentar el rendimiento por CPU hasta 10 veces en comparación con la API REST JSON. Google tiene previsto actualizar a gRPC tantas bibliotecas de cliente de Cloud como sea posible. Mientras tanto, seguirás disfrutando de todas las demás ventajas del código de la biblioteca de cliente de Google.
Otras formas de acceder a las APIs de Cloud
Si no quieres acceder a una API de forma programática, puedes acceder a algunas de las mismas funciones con las herramientas de la interfaz de línea de comandos de Google Cloud o con la consola deGoogle Cloud Google Cloud.