Bibliotecas cliente de la API de Google Chat

Las bibliotecas cliente optimizan la experiencia del desarrollador para llamar a la API de Google Chat, ya que reducen el código estándar que debes escribir. En esta guía, se presentan las bibliotecas cliente y se explica cómo instalarlas.

La API de Chat tiene interfaces gRPC y REST, y bibliotecas cliente que admiten ambas. Las bibliotecas cliente de Cloud admiten interfaces gRPC y REST, las bibliotecas cliente de la API de Google solo admiten la interfaz REST, pero puedes usar ambas bibliotecas cliente en el mismo proyecto. De manera opcional, si las bibliotecas cliente proporcionadas no satisfacen tus necesidades, puedes escribir tus propias bibliotecas cliente que usen la interfaz gRPC o REST.

Para obtener más información sobre los tipos de bibliotecas cliente que admite Google, consulta Explicación de bibliotecas cliente.

Instala bibliotecas cliente de Cloud (recomendado)

Las bibliotecas cliente de Cloud son las bibliotecas cliente más recientes y recomendadas para llamar a la API de Chat. Las bibliotecas cliente de Cloud admiten interfaces gRPC y REST.

La API de Chat proporciona bibliotecas cliente de Cloud para los siguientes lenguajes. Selecciona el idioma que quieres usar:

Node.js

Para instalar la biblioteca cliente, haz lo siguiente:

npm install @google-apps/chat

Más información:

Python

Para instalar la biblioteca cliente, haz lo siguiente:

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. Independientemente de la que uses, recuerda actualizar la versión a la versión más reciente disponible en GitHub.

Maven con BOM

Si usas Maven con una BOM, agrega lo siguiente al 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, sigue estos pasos:

  1. Cambia al directorio de tu proyecto: cd /my/cloud/project.
  2. Obtén el paquete que deseas usar:
go get cloud.google.com/go/chat

Más información:

Ruby

Para instalar la biblioteca cliente, haz lo siguiente:

gem install google-apps-chat

Más información:

PHP

Para instalar la biblioteca cliente, haz lo siguiente:

  1. Si es necesario, instala el administrador de dependencias Composer.
  2. Desde 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, haz lo siguiente:

Instala el paquete Google.Apps.Chat.V1 de NuGet. Agrégalo a tu proyecto de la manera habitual (por ejemplo, haz clic con el botón derecho en el proyecto de Visual Studio y selecciona “Administrar paquetes NuGet…”). Asegúrate de habilitar los paquetes previos al lanzamiento (por ejemplo, en la interfaz de usuario de NuGet de Visual Studio, marca la casilla “Incluir lanzamiento anticipado”).

Para instalar el paquete de NuGet, visita Google.Apis en NuGet.org.

Más información:

Instala las bibliotecas cliente de la API de Google

Las bibliotecas cliente de la API de Google, que son una alternativa a las bibliotecas cliente de Cloud, proporcionan acceso programático a la API de Chat con recursos y métodos de REST. Te recomendamos que uses las bibliotecas cliente de la API de Google si usas un lenguaje que no tiene una biblioteca cliente de Cloud o si extiendes un proyecto que ya las usa.

La API de Chat proporciona bibliotecas cliente de la API de Google para los siguientes idiomas. Selecciona el idioma que quieres 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 sobre cómo comenzar a usar la API de Google Chat con la biblioteca cliente de la API 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:

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 con la biblioteca cliente de la API 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 sobre cómo comenzar a usar la API de Google Chat con la biblioteca cliente de la API de Google para Python. Para obtener más información, consulta la siguiente documentación:

Requisitos del sistema

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

  1. Descarga la biblioteca cliente más reciente para Python.
  2. Descomprime el código.
  3. 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.

Ruby

Esta página contiene información sobre cómo comenzar a usar la API de Google Chat con la biblioteca cliente de la API 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 nuestras bibliotecas cliente de Cloud compatibles oficialmente para tu lenguaje preferido, como Python, Java o Node.js.

Si codificas con Google Apps Script, usa el servicio de Chat avanzado en lugar de instalar una biblioteca cliente.

Autenticación

Las llamadas a la API de Chat requieren autenticación. Cada método de la API de Chat requiere autenticación del usuario (para realizar acciones o acceder a datos en nombre de un usuario) o autenticación de la app (para realizar acciones o acceder a datos como una app de Chat). Algunos métodos 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.