Explicación de bibliotecas cliente

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Las bibliotecas cliente facilitan el acceso a las API de Google Cloud desde un lenguaje compatible. Si bien puedes usar las API de Google Cloud directamente mediante 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 proporciona Google para las API de Cloud. También puedes obtener más información sobre las bibliotecas disponibles para tu producto o idioma de preferencia en la documentación correspondiente.

Bibliotecas cliente de Cloud

Las bibliotecas cliente de Cloud son la opción recomendada para acceder a las API de Cloud de manera programática, cuando están disponibles. Las bibliotecas cliente de Cloud usan el modelo de biblioteca cliente más reciente y:

  • Proporcionar un código idiomático en cada lenguaje para que las API 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.
  • Controla todos los detalles de bajo nivel de comunicación con el servidor, incluida la autenticación con Google.
  • Se puede 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 API de gRPC.

Puedes encontrar las instrucciones de instalación y el material de referencia para la biblioteca cliente de Cloud en la página Bibliotecas cliente de las 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 API de Google Cloud no tienen bibliotecas cliente de Cloud disponibles en todos los lenguajes. Si deseas usar una de estas API y no hay una biblioteca cliente de Cloud para tu lenguaje preferido, aun así puedes usar el estilo anterior de biblioteca cliente, denominado bibliotecas cliente de la API de Google. También puedes usar estas bibliotecas si quieres actualizar 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.
  • Tener un código de interfaz generado de forma automática que podría no ser tan idiomático como las bibliotecas cliente de Cloud
  • Controla todos los detalles de bajo nivel de comunicación con el servidor, incluida la autenticación con Google.
  • Se puede instalar con herramientas de administración de paquetes conocidas, como npm y pip.

Estas bibliotecas están vinculadas en la página Bibliotecas cliente para las API de Cloud relevantes.

Usa la plataforma móvil de Firebase

Firebase es la solución de Google para compilar aplicaciones en dispositivos móviles. Ofrece un SDK con código de cliente que te permite acceder a las API de Cloud relevantes para dispositivos móviles desde iOS, Android y aplicaciones web. Para obtener información sobre las API 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 API 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 API 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 y neutral en cuanto al lenguaje y la plataforma que se desarrolló en un principio en Google. Puedes averiguarlo en grpc.io. Por lo general, las API de Cloud habilitadas para gRPC tienen interfaces de REST y RPC, en lugar de solo usar JSON sobre HTTP para comunicarse con la interfaz de REST, los clientes de API habilitadas para gRPC también pueden usar búferes de protocolo y gRPC por HTTP2 a fin de comunicarse con la interfaz de RPC. Puedes averiguar si una API está habilitada para gRPC si consultas sus secciones API y 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 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 para tu lenguaje preferido en grpc.io a fin de generar y usar tu cliente.

Si no deseas generar tu propio código gRPC, aún puedes beneficiarte de gRPC: un número cada vez mayor de bibliotecas cliente de Cloud para las API habilitadas para gRPC usan el funcionamiento interno de gRPC a fin de comunicarse con los servidores de Google. Esto es mucho más eficiente en términos de capacidad de procesamiento y uso de CPU: acceder a una API con gRPC puede aumentar la capacidad de procesamiento 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, obtendrás 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 quieres acceder a una API de manera programática, puedes acceder a algunas de las mismas funciones con las herramientas en Google Cloud CLI o con Google Cloud Console.