Las bibliotecas cliente optimizan la experiencia de los desarrolladores para llamar a la API de Google Chat reduciendo el código estándar que debes escribir. En esta guía, se presenta el bibliotecas cliente y explica cómo instalarlos.
La API de Chat tiene gRPC y REST interfaces de usuario y las bibliotecas cliente que admiten ambos. Las bibliotecas cliente de Cloud son compatibles con gRPC y REST de API de Google, las bibliotecas cliente de las APIs de Google solo admiten la interfaz REST, pero puedes usar ambas bibliotecas cliente en el mismo proyecto. De manera opcional, si porque las bibliotecas cliente proporcionadas no satisfacen tus necesidades, puedes escribir las tuyas las bibliotecas cliente que usan la interfaz gRPC o REST.
Para obtener más información los tipos de bibliotecas cliente que admite Google, consulta Explicación de las bibliotecas cliente.
Instala las bibliotecas cliente de Cloud (recomendado)
Bibliotecas cliente de Cloud son las bibliotecas cliente más recientes y recomendadas para llamar API de Chat. Las bibliotecas cliente de Cloud admiten gRPC y REST interfaces.
La API de Chat proporciona bibliotecas cliente de Cloud para los siguientes lenguajes. Selecciona el idioma que quieras usar:
Node.js
Para instalar la biblioteca cliente, sigue estos pasos:
npm install @google-apps/chat
Más información:
Python
Para instalar la biblioteca cliente, sigue estos pasos:
python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
Más información:
Java
Selecciona tu entorno de compilación en las siguientes pestañas. Sea cual sea recuerda actualizar la versión a la versión más reciente disponible en GitHub.
Maven con BOM
Si usas Maven con
BOM,
agrega lo siguiente a tu archivo pom.xml
:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.42.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
</dependency>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.10.0</version>
</dependency>
Maven sin BOM
Si usas Maven sin BOM, agrega lo siguiente a tus dependencias:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
Si usas Gradle sin BOM, agrega lo siguiente a tus dependencias:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
Si usas SBT, agrega esto a tus dependencias:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
Más información:
Go
Importa los paquetes de Go para los servicios de Google Cloud.
import "cloud.google.com/go"
Para instalar el paquete en tu sistema:
- Cambia al directorio de tu proyecto:
cd /my/cloud/project
. - Obtén el paquete que deseas usar:
go get cloud.google.com/go/chat
Más información:
Rita
Para instalar la biblioteca cliente, sigue estos pasos:
gem install google-apps-chat
Más información:
PHP
Para instalar la biblioteca cliente, sigue estos pasos:
- Si es necesario, instala el administrador de dependencias Composer.
- En la interfaz de línea de comandos, ejecuta lo siguiente:
composer require google/apps-chat
Más información:
.NET
Para instalar la biblioteca cliente, sigue estos pasos:
Instala el paquete Google.Apps.Chat.V1
de NuGet. Agrégala a tu
de forma normal (por ejemplo, haciendo clic con el botón derecho sobre el proyecto
Visual Studio y selecciona “Administrar paquetes NuGet...”. Asegúrate de
habilitar paquetes previos al lanzamiento (por ejemplo, en la biblioteca de usuario de NuGet de Visual Studio
de Google, marca el campo "Incluir lanzamiento anticipado" ).
Para instalar el paquete NuGet, visita Google.Apis en NuGet.org.
Más información:
Instala las bibliotecas cliente de las APIs de Google
Una alternativa a las bibliotecas cliente de Cloud, Bibliotecas cliente de las APIs de Google proporcionar acceso programático a la API de Chat mediante recursos de REST y . Es posible que prefieras usar las bibliotecas cliente de las APIs de Google si usas un lenguaje que no tiene una biblioteca cliente de Google Cloud, o si vas a extender un proyecto que ya las usa.
La API de Chat proporciona bibliotecas cliente de la API de Google para lo siguiente: idiomas. Selecciona el idioma que quieras usar:
Go
Obtén la biblioteca cliente de la API de Google Chat para Go (alfa) más reciente. Lee la guía para desarrolladores de la biblioteca cliente.
Java
Esta página contiene información para comenzar a usar la API de Google Chat usando la biblioteca cliente de las APIs de Google para Java. Para obtener más información, consulta la siguiente documentación:
Agrega la biblioteca cliente a tu proyecto
Selecciona tu entorno de compilación (Maven o Gradle) en las siguientes pestañas:
Agrega lo siguiente al archivo pom.xml
:
Consulta todas las versiones disponibles del repositorio central de Maven.
Agrega lo siguiente al archivo build.gradle
:
Consulta todas las versiones disponibles del repositorio central de Maven.
JavaScript
Lee la guía para desarrolladores de la biblioteca cliente.
.NET
Esta página contiene información para comenzar a usar la API de Google Chat usando la biblioteca cliente de las APIs de Google para .NET. Para obtener más información, consulta la siguiente documentación:
Descarga la biblioteca
Instala el paquete de NuGet: Google.Apis.
Node.js
Obtén la biblioteca cliente de la API de Google Chat para Node.js más reciente. Lee la guía para desarrolladores de la biblioteca cliente.
Obj-C
Obtén la biblioteca cliente de la API de Google Chat para Objective-C más reciente. Lee la guía para desarrolladores de la biblioteca cliente.
PHP
Obtén la biblioteca cliente de la API de Google Chat para PHP más reciente. Lee la guía para desarrolladores de la biblioteca cliente.
Python
Esta página contiene información para comenzar a usar la API de Google Chat usando la biblioteca cliente de las APIs de Google para Python. Para obtener más información, consulta la siguiente documentación:
Requisitos del sistema
- Sistemas operativos:
- Linux
- macOS X
- Windows
- Python 2.7, 3.4 o una versión posterior
Instala la biblioteca cliente
Puedes usar un administrador de paquetes o descargar e instalar de forma manual la biblioteca cliente de Python:
Instalación administrada
Usa pip o setuptools para administrar la instalación (es posible que primero debas ejecutar sudo
).
- pip (opción preferida):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
Instalación manual
- Descarga la biblioteca cliente más reciente para Python.
- Descomprime el código.
- Instala:
python setup.py install
App Engine
Como las bibliotecas cliente de Python no están instaladas en el entorno de ejecución de App Engine para Python, debes copiarlas en tu aplicación al igual que las bibliotecas de terceros.
Rita
Esta página contiene información para comenzar a usar la API de Google Chat usando la biblioteca cliente de las APIs de Google para Ruby. Para obtener más información, consulta la siguiente documentación:
Instala la gema google-api-client
Según el sistema, es posible que debas anteponer estos comandos con sudo
.
Si nunca instalaste la biblioteca cliente de la API de Google para Ruby, instálala con RubyGems
:
gem install google-api-client
Si ya instalaste la gema, actualiza a la versión más reciente:
gem update -y google-api-client
Cómo comenzar a usar la biblioteca cliente de la API de Google para Ruby
Para obtener información sobre cómo realizar tu primera solicitud, consulta la Guía de introducción.
Apps Script y bibliotecas cliente
La forma recomendada para que la mayoría de los desarrolladores llamen a la API de Google Chat es con nuestra asistencia oficial Bibliotecas cliente de Cloud para tu lenguaje preferido, como Python, Java o Node.js.
Si estás programando con Google Apps Script, usa la Servicio de chat avanzado en lugar de instalar una biblioteca cliente.
Autenticación
Se requiere autenticación para llamar a la API de Chat. Cada El método de la API de Chat requiere lo siguiente: autenticación de usuarios (para realizar acciones o acceder datos en nombre de un usuario) o autenticación de apps (para realizar acciones o acceder a datos como una app de Chat). Algunos admiten la autenticación de usuarios y la autenticación de apps.
Para obtener más información sobre la autenticación en Chat, consulta Descripción general de la autenticación.