Las bibliotecas de cliente facilitan el acceso a las Google Cloud APIs desde un lenguaje admitido. Aunque puedes usar las Google Cloud 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.
En este documento se explican los distintos tipos de bibliotecas de cliente que proporciona Google para las APIs de Cloud. También puede consultar más información sobre las bibliotecas disponibles para su producto o idioma en la documentación del producto o del idioma.
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 de Cloud sean sencillas e intuitivas de usar.
- Proporcionar un estilo coherente en todas las bibliotecas de cliente para simplificar el trabajo con varios servicios 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. - En algunos casos, te ofrecen ventajas de rendimiento al usar gRPC. Para obtener más información, consulta las APIs de gRPC.
Puedes consultar las instrucciones de instalación y el material de referencia de la biblioteca de cliente de Cloud en la página Bibliotecas de cliente de las APIs de Cloud que utilices. En la página de bibliotecas de cliente de Cloud, encontrarás enlaces para empezar a usar las bibliotecas de cliente de Cloud y su documentación de referencia.
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
Algunas APIs de Google Cloud no tienen bibliotecas de cliente de Cloud disponibles en todos los lenguajes. Si quieres usar una de estas APIs y no hay una biblioteca de cliente de Cloud para el lenguaje que prefieres, puedes usar el estilo anterior de biblioteca de cliente, llamado bibliotecas de cliente de la API de 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.
- Tener código de interfaz generado automáticamente que puede que no sea tan idiomático como las bibliotecas de 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.
Estas bibliotecas se enlazan en la página Bibliotecas de cliente de las APIs de Cloud correspondientes.
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 las APIs de Cloud relevantes para móviles desde aplicaciones iOS, Android y web. Para obtener información sobre las APIs de Cloud compatibles y sobre cómo empezar a usar Firebase, consulta la documentación de Firebase.
Usar tu propio código de cliente
Si eres un desarrollador con experiencia y las bibliotecas de cliente de Google no se ajustan a 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 Cloud exponen una interfaz JSON/REST tradicional sencilla. 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 de Cloud con diferentes versiones e implementaciones de HTTP en las directrices de HTTP.
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 de Cloud habilitadas para 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 las APIs habilitadas para 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 de Cloud tiene habilitado gRPC, puedes generar tus propias bibliotecas de cliente de gRPC en cualquier lenguaje compatible con gRPC. Para ello, necesitará 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 beneficiarte de gRPC: un número cada vez mayor de bibliotecas de cliente de Cloud para APIs habilitadas para gRPC usan gRPC "bajo el capó" para comunicarse con los servidores de Google. Esto 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 consolaGoogle Cloud .