Explicación de bibliotecas cliente

Las bibliotecas cliente facilitan el acceso APIs de Google Cloud en un idioma compatible. Si bien puedes usar las APIs de Google Cloud directamente con solicitudes sin procesar al servidor, las bibliotecas cliente proporcionan simplificaciones que reducen significativamente la cantidad de código que debes escribir.

En este documento, se explican los diferentes tipos de bibliotecas cliente que para las API de Cloud. También puedes encontrar más información sobre los bibliotecas para el producto o el idioma que elijas en el en la documentación de Google Cloud.

Bibliotecas cliente de Cloud

Bibliotecas cliente de Cloud son la opción recomendada para acceder a las API de Cloud de manera programática, en la que disponibles. Las bibliotecas cliente de Cloud usan el modelo más reciente de biblioteca cliente y tienen las siguientes características:

  • Proporcionar código idiomático en cada lenguaje para hacer que las API de Cloud sean sencillas y sean intuitivos de usar.
  • Proporciona un estilo coherente en todas las bibliotecas cliente para simplificar el trabajo con múltiples servicios en la nube.
  • Manejar todos los detalles de bajo nivel de comunicación con el servidor, lo que incluye la autenticación con Google.
  • Se pueden instalar con herramientas de administración de paquetes conocidas, como npm y pip
  • 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 de Google Cloud en la página de bibliotecas cliente de la API de Cloud que estás usando. 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 gratis

Bibliotecas cliente de la API de Google

Algunas APIs de Google Cloud no tienen bibliotecas cliente de Cloud disponibles en todas idiomas. Si quieres usar una de estas APIs y no hay de Google Cloud para tu lenguaje preferido, aún puedes usar la versión anterior estilo de biblioteca cliente, llamado Bibliotecas cliente de la API de Google También puedes usarlas si actualizas un proyecto que ya los 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.
  • Manejar todos los detalles de bajo nivel de comunicación con el servidor, lo que incluye la autenticación con Google.
  • Se pueden instalar con herramientas de administración de paquetes conocidas, como npm y pip.

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 contenido API de Cloud de iOS, Android y apps web. Para obtener información sobre los de API de Cloud y cómo comenzar a usar Firebase, consulta el Documentación de Firebase.

Usa tu propio código cliente

Si eres un desarrollador con experiencia y las bibliotecas cliente de Google no cumplen con tus específicas, puedes escribir tu propio código personalizado para acceder a la interfaz APIs de servicio de nivel inferior directamente.

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 averiguarlo en grpc.io. API de Cloud habilitadas para gRPC generalmente tienen interfaces de REST y RPC, así que, que solo usar JSON en HTTP para hablar con la interfaz REST, la API habilitada para gRPC los clientes también pueden usar búferes de protocolo y gRPC mediante HTTP2 para comunicarse con la interfaz de RPC. Puedes averiguar si una API es gRPC está habilitado mediante la verificación de sus APIs y sección de referencia.

Si una API de Cloud está habilitada para gRPC, puedes generar tus propias bibliotecas cliente de gRPC. en cualquier lenguaje compatible con gRPC. Para hacerlo, necesitarás los atributos búferes de protocolo definición del servicio (suele estar disponible desde el repositorio en GitHub). Luego, puedes seguir las instrucciones para tu idioma de preferencia en grpc.io 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 significativamente más eficiente en términos de capacidad de procesamiento y uso de CPU, el acceso a una API usar gRPC puede aumentar la capacidad de procesamiento por CPU hasta en un factor de 10, en comparación a 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.