Explicación de bibliotecas cliente

Si bien puedes usar las API de Google Cloud mediante las solicitudes HTTP directas al servidor (o las llamadas RPC si están disponibles), nosotros proporcionamos el código de la biblioteca cliente para todas nuestras API de Cloud que facilitan el acceso a estas desde tus lenguajes favoritos. En este documento, se explican los tipos de bibliotecas cliente diferentes que proporcionamos para las API de Cloud. 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 Google Cloud

Las bibliotecas cliente de Google Cloud usan nuestro modelo más reciente de biblioteca cliente y son nuestra opción recomendada para acceder a las API de Cloud de manera programática, si están disponibles. Las bibliotecas cliente de Cloud cuentan con las características siguientes:

  • Proporcionan códigos idiomáticos, generados o escritos a mano en cada lenguaje que hacen que la API de Cloud sea intuitiva y fácil de usar.
  • 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 conocidos como npm y pip.
  • En algunos casos, te brindan beneficios de rendimiento mediante gRPC. Puedes obtener más información en la sección de las API de gRPC a continuación.

Puedes obtener las instrucciones de instalación y el material de referencia para la biblioteca cliente de Cloud adecuada en la página de bibliotecas cliente de la API de Cloud que elegiste.

Para casi todos nuestros lenguajes compatibles, también puedes descargar una sola biblioteca cliente que proporciona una interfaz para todas las API de Cloud compatibles. Puedes encontrar vínculos a fin de comenzar a usarlas y su documentación de referencia en nuestra página de bibliotecas cliente de Cloud.

Bibliotecas cliente de la API de Google

Algunas API de Google Cloud aún no tienen disponibles las bibliotecas cliente de Google Cloud en todos los lenguajes. Si deseas usar una de estas API y no existe una biblioteca cliente para el lenguaje de tu preferencia, de igual manera puedes usar una versión anterior de nuestras bibliotecas cliente llamadas bibliotecas cliente de la API de Google. 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 nuestras bibliotecas más nuevas.
  • 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 conocidos como npm y pip.

Encontrarás vínculos para estas bibliotecas en la página de bibliotecas cliente de la API de Cloud relevante, cuando sea necesario.

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 API de Cloud relevantes para dispositivos móviles directo desde iOS, Android, y apps web. Visita la documentación de Firebase para obtener más información sobre qué API de Cloud es compatible y cómo comenzar a usar Firebase.

Usa tu propio código cliente

En general, recomendamos usar nuestras bibliotecas cliente para acceder a las API de Cloud. Sin embargo, si eres un desarrollador con experiencia y nuestras bibliotecas cliente no cumplen con tus necesidades específicas, puedes escribir tu propio código personalizado para acceder a las API de servicio de nivel inferior del servicio de forma directa.

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 de forma directa a la API de REST con una biblioteca cliente HTTP de terceros de tu preferencia, puedes obtener más información sobre cómo funcionan las API de Cloud con diferentes implementaciones y versiones HTTP en nuestros Lineamientos HTTP.

API de gRPC

gRPC es un sistema independiente del lenguaje, de plataforma neutra, de código abierto y llamada de procedimiento remoto (RPC) desarrollada en primera instancia en Google. Puedes obtener mucha más información en grpc.io. Las API de Cloud con gRPC habilitado, por lo general, cuentan con las interfaces REST y RPC, así que en lugar de solo usar JSON en HTTP para comunicarte con la interfaz de REST, los clientes de la API con gRPC habilitada también pueden usar búferes de protocolo y gRPC en HTTP2 para comunicarse con la interfaz RPC. Puedes averiguar si una API está habilitada para gRPC si compruebas su sección de las API 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 nuestro repositorio en GitHub). 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 API con gRPC habilitadas usan gRPC “de forma interna” a fin de comunicarse con los servidores de Google. Esto es mucho más eficaz de acuerdo con capacidad de procesamiento y el uso de la CPU: acceder a una API con gRPC puede aumentar la capacidad de procesamiento por CPU hasta un factor de 10 comparado con la API de JSON y REST. Tenemos planeado actualizar tantas bibliotecas cliente de Cloud como sea posible en gRPC; mientras tanto, aún obtendrás todas las otras ventajas de nuestro código de biblioteca cliente.

Otras formas de acceder a las API de Cloud

Si no deseas acceder a una API de manera programática, puedes acceder a la misma funcionalidad con las herramientas en el SDK de Google Cloud o mediante Google Cloud Platform Console.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...