Si bien puedes usar las Google Cloud APIs de directamente con 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 métodos para interactuar con las Google Cloud APIs:
- Bibliotecas cliente de Cloud (recomendado)
- Bibliotecas cliente de la API de Google
- Firebase para dispositivos móviles
- Tu propio código cliente
Para encontrar información sobre la biblioteca cliente de un producto específico, consulta la sección de bibliotecas cliente en la documentación de ese producto. Google Cloud Para ver todas las bibliotecas cliente de Cloud, que a menudo se organizan por lenguaje admitido, consulta Bibliotecas cliente de Cloud.
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, si están disponibles. Las bibliotecas cliente de Cloud usan el modelo de biblioteca cliente más reciente y tienen las siguientes características:
- Proporcionan código idiomático en cada lenguaje para que Google Cloud APIs sean intuitivas de usar.
- Proporcionan un estilo coherente en todas las bibliotecas cliente para simplificar el trabajo con varios Google Cloud servicios.
- 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 APIs de gRPC.
Las instrucciones de instalación y los materiales de referencia para las bibliotecas cliente de Cloud dependen de la API específica Google Cloud y del lenguaje de programación que uses. Para encontrar esta información, consulta la documentación del producto Google Cloud específico. La mayoría de los productos incluyen una sección de "Bibliotecas cliente" en su documentación, que proporciona orientación específica del lenguaje, pasos de instalación y vínculos a la referencia detallada de la API.
Puedes encontrar la documentación de un producto específico si navegas por la Google Cloud biblioteca de APIs.
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
Si las bibliotecas cliente de Cloud no están disponibles para tu lenguaje preferido para una API específica, puedes usar las bibliotecas cliente de la API de Google. Este es un tipo anterior de biblioteca cliente que proporciona 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.
Usa la plataforma de desarrollo de Firebase
Firebase es la plataforma de servicios de Google diseñada para admitir todo el ciclo de vida de desarrollo de tu app. Proporciona SDK multiplataforma para ayudarte a ti y a los agentes de IA a compilar y ejecutar apps para plataformas de Apple, Android, la Web, Flutter, Unity y C++.
Para obtener información sobre las APIs compatibles Google Cloud 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 Cloud no satisfacen tus necesidades específicas, puedes escribir tu propio código personalizado para acceder a las APIs de servicio de nivel inferior del servicio de forma directa.
APIs de REST y HTTP
Todas las Google Cloud APIs exponen una interfaz JSON y REST. 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, puedes obtener más información sobre cómo funcionan las APIs Google Cloud con diferentes implementaciones y versiones HTTP en los Lineamientos HTTP.
APIs 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 más información en grpc.io. Las APIs con gRPC habilitado Google Cloud , 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 APIs y referencias.
Si una Google Cloud API 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).
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" para 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 REST de JSON. Google planea actualizar tantas bibliotecas cliente de Cloud como sea posible en gRPC; mientras tanto, aún obtendrás todas las otras ventajas del código de 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 Google Cloud consola.