Bibliothèques clientes de l'API Google Chat

Les bibliothèques clientes optimisent l'expérience développeur pour appeler l'API Google Chat en réduisant le code récurrent que vous devez écrire. Ce guide présente les bibliothèques clientes et explique comment les installer.

L'API Chat dispose d'interfaces gRPC et REST, ainsi que de bibliothèques clientes compatibles avec les deux. Les bibliothèques clientes Cloud sont compatibles avec les interfaces gRPC et REST, tandis que les bibliothèques clientes des API Google ne sont compatibles qu'avec l'interface REST. Toutefois, vous pouvez utiliser les deux bibliothèques clientes dans le même projet. Si les bibliothèques clientes fournies ne répondent pas à vos besoins, vous pouvez également écrire vos propres bibliothèques clientes qui utilisent l'interface gRPC ou REST.

Pour en savoir plus sur les types de bibliothèques clientes compatibles avec Google, consultez la section Présentation des bibliothèques clientes.

Installer les bibliothèques clientes Cloud (recommandé)

Les bibliothèques clientes Cloud sont les bibliothèques clientes les plus récentes et les plus recommandées pour appeler l'API Chat. Les bibliothèques clientes Cloud sont compatibles avec les interfaces gRPC et REST.

L'API Chat fournit des bibliothèques clientes Cloud pour les langages suivants. Sélectionnez la langue que vous souhaitez utiliser:

Node.js

Pour installer la bibliothèque cliente:

npm install @google-apps/chat

En savoir plus :

Python

Pour installer la bibliothèque cliente:

python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat

En savoir plus :

Java

Sélectionnez votre environnement de compilation dans les onglets suivants. Quelle que soit l'option que vous choisissez, n'oubliez pas de passer à la version la plus récente disponible sur GitHub.

Maven avec BOM

Si vous utilisez Maven avec un BOM, ajoutez les éléments suivants à votre fichier 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 sans BOM

Si vous utilisez Maven sans BOM, ajoutez les éléments suivants à vos dépendances:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.9.0</version>
</dependency>

Gradle

Si vous utilisez Gradle sans BOM, ajoutez ceci à vos dépendances:

implementation 'com.google.cloud:google-cloud-chat:0.10.0'

SBT

Si vous utilisez SBT, ajoutez ceci à vos dépendances :

libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"

En savoir plus :

Go

Importez les packages Go pour les services Google Cloud.

import "cloud.google.com/go"

Pour installer le package sur votre système:

  1. Accédez au répertoire de votre projet: cd /my/cloud/project.
  2. Obtenez le package que vous souhaitez utiliser:
go get cloud.google.com/go/chat

En savoir plus :

Ruby

Pour installer la bibliothèque cliente:

gem install google-apps-chat

En savoir plus :

PHP

Pour installer la bibliothèque cliente:

  1. Si nécessaire, installez le gestionnaire de dépendances Composer.
  2. Dans votre interface de ligne de commande, exécutez la commande suivante:
composer require google/apps-chat

En savoir plus :

.NET

Pour installer la bibliothèque cliente:

Installez le package Google.Apps.Chat.V1 depuis NuGet. Ajoutez-le normalement à votre projet (par exemple, en cliquant avec le bouton droit sur le projet dans Visual Studio et en choisissant "Gérer les packages NuGet"). Assurez-vous d'activer les packages préliminaires (par exemple, dans l'interface utilisateur NuGet de Visual Studio, cochez la case "Inclure la version préliminaire").

Pour installer le package NuGet, consultez Google.Apis sur NuGet.org.

En savoir plus :

Installer les bibliothèques clientes des API Google

Alternative aux bibliothèques clientes Cloud, les bibliothèques clientes des API Google permettent d'accéder de manière automatisée à l'API Chat à l'aide de ressources et de méthodes REST. Vous pouvez préférer utiliser les bibliothèques clientes des API Google si vous utilisez un langage pour lequel aucune bibliothèque cliente Cloud n'est disponible ou si vous étendez un projet qui les utilise déjà.

L'API Chat fournit des bibliothèques clientes pour les API Google pour les langues suivantes. Sélectionnez la langue que vous souhaitez utiliser:

Go

Obtenez la dernière bibliothèque cliente de l'API Google Chat pour Go (alpha). Consultez le guide du développeur de la bibliothèque cliente.

Java

Cette page explique comment commencer à utiliser l'API Google Chat à l'aide de la bibliothèque cliente des API Google pour Java. Pour en savoir plus, consultez la documentation suivante :

Ajouter la bibliothèque cliente à votre projet

Sélectionnez votre environnement de compilation (Maven ou Gradle) dans les onglets suivants :

JavaScript

Consultez le guide du développeur de la bibliothèque cliente.

.NET

Cette page explique comment commencer à utiliser l'API Google Chat à l'aide de la bibliothèque cliente des API Google pour .NET. Pour en savoir plus, consultez la documentation suivante:

Télécharger la bibliothèque

Installez le package NuGet : Google.Apis.

Node.js

Obtenez la dernière bibliothèque cliente de l'API Google Chat pour Node.js. Consultez le guide du développeur de la bibliothèque cliente.

Obj-C

Obtenez la dernière bibliothèque cliente de l'API Google Chat pour Objective-C. Consultez le guide du développeur de la bibliothèque cliente.

PHP

Obtenez la dernière bibliothèque cliente de l'API Google Chat pour PHP. Consultez le guide du développeur de la bibliothèque cliente.

Python

Cette page explique comment commencer à utiliser l'API Google Chat à l'aide de la bibliothèque cliente des API Google pour Python. Pour en savoir plus, consultez la documentation suivante :

Configuration requise

Installer la bibliothèque cliente

Vous pouvez utiliser un gestionnaire de packages ou télécharger et installer manuellement la bibliothèque cliente Python :

Installation gérée

Utilisez "pip" ou "setuptools" pour gérer votre installation. Vous devrez peut-être d'abord exécuter sudo.

  • pip (option à privilégier) :
    pip install --upgrade google-api-python-client
  • Setuptools :
    easy_install --upgrade google-api-python-client

Installation manuelle

  1. Téléchargez la dernière bibliothèque cliente pour Python.
  2. Décompressez le code.
  3. Installation :
    python setup.py install

App Engine

Comme les bibliothèques clientes Python ne sont pas installées dans l'environnement d'exécution Python pour App Engine, vous devez les intégrer à l'application par , comme les bibliothèques tierces.

Ruby

Cette page explique comment commencer à utiliser l'API Google Chat à l'aide de la bibliothèque cliente des API Google pour Ruby. Pour en savoir plus, consultez la documentation suivante :

Installer le gem google-api-client

Selon votre système, vous devrez peut-être ajouter le préfixe sudo à ces commandes.

Si vous n'avez pas encore installé la bibliothèque cliente des API Google pour Ruby, installez-la à l'aide de RubyGems :

gem install google-api-client

Si vous avez déjà installé le gem, mettez-le à jour pour obtenir la dernière version :

gem update -y google-api-client

Premiers pas avec la bibliothèque cliente des API Google pour Ruby

Pour découvrir comment effectuer votre première requête, consultez le guide de démarrage.

Apps Script et bibliothèques clientes

La plupart des développeurs appellent l'API Google Chat à l'aide de nos bibliothèques clientes Cloud officiellement compatibles avec le langage de votre choix, comme Python, Java ou Node.js.

Si vous codez avec Google Apps Script, utilisez le service Chat avancé au lieu d'installer une bibliothèque cliente.

Authentification

L'appel de l'API Chat nécessite une authentification. Chaque méthode de l'API Chat nécessite une authentification de l'utilisateur (pour effectuer des actions ou accéder aux données au nom d'un utilisateur) ou une authentification de l'application (pour effectuer des actions ou accéder aux données en tant qu'application Chat). Certaines méthodes sont compatibles à la fois avec l'authentification des utilisateurs et l'authentification des applications.

Pour en savoir plus sur l'authentification dans Chat, consultez la section Présentation de l'authentification.