Les bibliothèques clientes optimisent l'expérience développeur pour les appels à l'API Google Chat en réduisant la quantité de code récurrent à écrire. Ce guide présente les bibliothèques clientes et explique comment les installer.
L'API Chat offre gRPC et REST d'interfaces et des bibliothèques clientes compatibles avec les deux. Les bibliothèques clientes Cloud sont compatibles avec gRPC et REST les bibliothèques clientes des API Google ne prennent en charge que l'interface REST, peuvent utiliser les deux bibliothèques clientes dans le même projet. Éventuellement, si les bibliothèques clientes fournies ne répondent pas à vos besoins, vous pouvez écrire vos propres qui utilisent l'interface gRPC ou REST.
Pour en savoir plus sur les types de bibliothèques clientes compatibles avec Google, consultez Présentation des bibliothèques clientes
Installer des bibliothèques clientes Cloud (recommandé)
Bibliothèques clientes Cloud sont les bibliothèques clientes les plus récentes et recommandées pour appeler API Chat. Les bibliothèques clientes Cloud sont compatibles avec gRPC et REST de commande.
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, procédez comme suit:
npm install @google-apps/chat
<ph type="x-smartling-placeholder">
En savoir plus :
Python
Pour installer la bibliothèque cliente, procédez comme suit:
<ph type="x-smartling-placeholder">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. Quel que soit votre modèle n'oubliez pas d'installer la dernière version disponible sur GitHub.
Maven avec BOM
Si vous utilisez Maven avec
BOM
Ajoutez ceci à 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 ceci à 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, procédez comme suit:
gem install google-apps-chat
En savoir plus :
PHP
Pour installer la bibliothèque cliente, procédez comme suit:
- Si nécessaire, installez le gestionnaire de dépendances Composer :
- Depuis 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, procédez comme suit:
Installez le package Google.Apps.Chat.V1
depuis NuGet. Ajoutez-le à votre
effectuer un projet de manière ordinaire (par exemple, en faisant un clic droit sur le projet dans
Visual Studio, puis en sélectionnant "Gérer les packages NuGet...". Assurez-vous que
activer les packages de version préliminaire (par exemple, dans les interfaces utilisateur NuGet de Visual Studio,
cochez la case "Inclure la version préliminaire", ).
Pour installer le package NuGet, accédez à Google.Apis sur NuGet.org
En savoir plus :
Installer les bibliothèques clientes des API Google
Les bibliothèques clientes Cloud peuvent être une alternative Bibliothèques clientes pour les API Google fournir un accès programmatique à l'API Chat à l'aide de ressources REST ; méthodes. Vous préférez peut-être utiliser Bibliothèques clientes pour les API Google si vous utilisez un langage ou si vous étendez un projet qui les utilise déjà.
L'API Chat fournit des bibliothèques clientes pour les API Google langues. 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 contient des informations sur la prise en main de 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 contient des informations sur la prise en main de 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 contient des informations sur la prise en main de 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 contient des informations sur la prise en main de 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 méthode recommandée pour que la plupart des développeurs appellent l'API Google Chat est le numéro de téléphone officiel Bibliothèques clientes Cloud dans le langage de votre choix, comme Python, Java ou Node.js.
Si vous codez avec Google Apps Script, utilisez la Service Chat avancé au lieu d'installer une bibliothèque cliente.
Authentification
Vous devez vous authentifier pour appeler l'API Chat. Chaque La méthode de l'API Chat requiert authentification utilisateur (pour effectuer des actions ou accéder données au nom d'un utilisateur) ou authentification des applications (pour effectuer des actions ou accéder à des données en tant qu'application Chat). Un peu prennent en charge à la fois l'authentification des utilisateurs et l'authentification des applications.
Pour en savoir plus sur l'authentification dans Chat, consultez Présentation de l'authentification