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:
- Accédez au répertoire de votre projet:
cd /my/cloud/project
. - 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:
- Si nécessaire, installez le gestionnaire de dépendances Composer.
- 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 :
Ajoutez le code ci-dessous à votre fichier pom.xml
:
Affichez toutes les versions disponibles dans le référentiel central de Maven.
Ajoutez le code ci-dessous à votre fichier build.gradle
:
Affichez toutes les versions disponibles dans le référentiel central de Maven.
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
- Systèmes d'exploitation :
- Linux
- macOS X
- Windows
- Python 2.7, 3.4 ou version ultérieure
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
- Téléchargez la dernière bibliothèque cliente pour Python.
- Décompressez le code.
- 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.