Las bibliotecas cliente facilitan el acceso a las APIs deGoogle Cloud desde un lenguaje compatible. Si bien puedes usar las APIs de Google Cloud directamente mediante solicitudes sin procesar al servidor, las bibliotecas cliente proporcionan simplificaciones que reducen de manera significativa la cantidad de código que debes escribir.
En este documento, se explican los diferentes tipos de bibliotecas cliente que Google proporciona para las APIs de Cloud. También puedes obtener más información sobre las bibliotecas disponibles del producto o lenguaje que elijas en la documentación del producto o lenguaje.
Bibliotecas cliente de Cloud
Las bibliotecas cliente de Cloud son la opción recomendada para acceder a las APIs de Cloud de manera programática, si están disponibles. Las bibliotecas cliente de Cloud usan el modelo más reciente de biblioteca cliente y tienen las siguientes características:
- Proporcionan código idiomático en cada lenguaje para que las APIs de Cloud sean intuitivas y fáciles de usar.
- Proporciona un estilo coherente en todas las bibliotecas cliente para simplificar el trabajo con varios servicios de Cloud.
- Controlan todos los detalles de nivel bajo de comunicación con el servidor, incluida la autenticación con Google.
- Se pueden instalar con herramientas de administración de paquetes conocidas, como
npmypip. - En algunos casos, te brindan beneficios de rendimiento mediante gRPC. Para obtener más información, consulta las APIs de gRPC.
Puedes encontrar instrucciones de instalación y material de referencia para la biblioteca cliente de Cloud en la página de bibliotecas cliente de las API de Cloud que usas. Puedes encontrar vínculos para comenzar a usar las bibliotecas cliente de Cloud y su documentación de referencia en la página de bibliotecas cliente de Cloud.
Pruébalo tú mismo
Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Comenzar gratisBibliotecas cliente de la API de Google
Algunas APIs de Google Cloud no tienen bibliotecas cliente de Cloud disponibles en todos los idiomas. Si deseas usar una de estas APIs y no existe una biblioteca cliente de Cloud para el lenguaje de tu preferencia, de igual manera puedes usar el estilo anterior de biblioteca cliente, llamado bibliotecas cliente de la API de Google. También puedes usar estas bibliotecas si actualizas un proyecto que ya las usa. Estas bibliotecas cuentan con las características siguientes:
- Proporcionan acceso solo a la interfaz REST de la API; gRPC no es compatible.
- Tienen un código de interfaz generado de forma automática que puede no ser tan idiomático como las bibliotecas cliente de Cloud.
- Controlan todos los detalles de nivel bajo de comunicación con el servidor, incluida la autenticación con Google.
- Se pueden instalar con herramientas de administración de paquetes conocidas, como
npmypip.
Estas bibliotecas están vinculadas en la página de bibliotecas cliente de las APIs de Cloud relevantes.
Usa la plataforma móvil de Firebase
Firebase es la solución de todos los productos de Google para compilar aplicaciones en dispositivos móviles. Ofrece un SDK con código de cliente que te permite acceder a las APIs de Cloud relevantes para dispositivos móviles desde iOS, Android y apps web. Si quieres obtener información sobre las APIs de Cloud compatibles y cómo comenzar a usar Firebase, consulta la documentación de Firebase.
Usa tu propio código cliente
Si eres un desarrollador con experiencia y las bibliotecas cliente de Google 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.
API de REST y HTTP
Todas las API de Cloud exponen una interfaz tradicional JSON y REST sencilla. Si necesitas escribir tu propio código personalizado para acceder directamente a la API de REST con una biblioteca cliente HTTP de terceros, puedes obtener más información sobre cómo funcionan las APIs de Cloud con diferentes implementaciones y versiones HTTP en los Lineamientos HTTP.
API de gRPC
gRPC es un sistema de llamada de procedimiento remoto (RPC) de código abierto, independiente de la plataforma y del lenguaje, que se desarrolló inicialmente en Google. Puedes obtener información al respecto en grpc.io. En general, las APIs de Cloud habilitadas para gRPC tienen 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 la API habilitados para gRPC también pueden usar búferes de protocolo y gRPC a través de HTTP2 para comunicarse con la interfaz RPC. Puedes averiguar si una API está habilitada para gRPC si compruebas su sección de las APIs y referencias.
Si una API de Cloud está habilitada para gRPC, puedes generar tus propias bibliotecas cliente gRPC para esta en cualquier lenguaje compatible con gRPC. Para ello, necesitarás la definición del servicio de los búferes de protocolo de la API (por lo general, disponibles en el repositorio en GitHub). Luego, puedes seguir las instrucciones según tu lenguaje de preferencia en grpc.io para generar y usar tu cliente.
Si no deseas generar tu propio código gRPC, aun así puedes beneficiarte de gRPC: un número creciente de bibliotecas cliente de Cloud para las APIs con gRPC habilitadas usan gRPC “de forma interna” a fin de comunicarse con los servidores de Google. Esto es mucho más eficiente en términos de rendimiento y uso de la CPU: el acceso a una API con gRPC puede aumentar el rendimiento por CPU hasta en un factor de 10 en comparación con la API de REST de JSON. Google planea actualizar tantas bibliotecas cliente de Cloud como sea posible a gRPC. Mientras tanto, seguirás obteniendo todas las demás ventajas del código de la biblioteca cliente de Google.
Otras formas de acceder a las API de Cloud
Si no deseas acceder a una API de manera programática, puedes acceder a parte de la misma funcionalidad con las herramientas en Google Cloud CLI o con la consola de Google Cloud.