Ce guide explique comment utiliser la méthode get()
sur la ressource Message
de l'API Google Chat pour renvoyer des informations sur un message de texte ou de fiche.
Dans l'API Chat, un message Chat est représenté par l'icône
Ressource Message
.
Alors que les utilisateurs de Chat ne peuvent envoyer que des messages contenant du texte, les applications Chat peuvent utiliser de nombreuses autres fonctionnalités de messagerie, y compris l'affichage d'interfaces utilisateur statiques ou interactives, la collecte d'informations auprès des utilisateurs et la diffusion de messages privés. Pour en savoir plus sur la messagerie
disponibles pour l'API Chat, consultez la
Présentation des messages Google Chat
Prérequis
Node.js
- Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurez l'écran de consentement OAuth.
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Installez la Node.js bibliothèque cliente Cloud.
- Créez des identifiants d'accès en fonction de la manière dont vous souhaitez vous authentifier dans votre API Google Chat.
requête:
<ph type="x-smartling-placeholder">
- </ph>
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
client_secrets.json
dans votre répertoire local. - Pour vous authentifier en tant qu'application Chat, créez des identifiants de compte de service et enregistrez-les en tant que fichier JSON nommé
credentials.json
.
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
- <ph type="x-smartling-placeholder"></ph> Choisissez un champ d'application d'autorisation selon que vous souhaitez vous authentifier en tant qu'utilisateur Application Chat
- Un espace Google Chat dans lequel l'utilisateur authentifié ou l'application Chat appelant est membre. Pour vous authentifier en tant qu'application Chat, ajoutez l'application Chat à l'espace.
Python
- Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- Activez et configurez l'API Google Chat avec un nom, une icône et une description pour votre application Chat.
- Installez la bibliothèque cliente Cloud pour Python.
- Créez des identifiants d'accès en fonction de la manière dont vous souhaitez vous authentifier dans votre API Google Chat.
requête:
<ph type="x-smartling-placeholder">
- </ph>
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
client_secrets.json
dans votre répertoire local. - Pour vous authentifier en tant qu'application Chat,
créer un compte de service
identifiants et enregistrez-les dans un fichier JSON nommé
credentials.json
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
- <ph type="x-smartling-placeholder"></ph> Choisissez un champ d'application d'autorisation selon que vous souhaitez vous authentifier en tant qu'utilisateur Application Chat
- Un espace Google Chat dans lequel l'utilisateur authentifié ou l'application Chat appelant est membre. Pour vous authentifier en tant qu'application Chat, ajoutez l'application Chat à l'espace.
Java
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement :
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- Activez et configurez l'API Google Chat avec un nom, une icône et une description pour votre application Chat.
- Installez la bibliothèque cliente Cloud pour Java.
- Créez des identifiants d'accès en fonction de la manière dont vous souhaitez vous authentifier dans votre API Google Chat.
requête:
<ph type="x-smartling-placeholder">
- </ph>
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
client_secrets.json
dans votre répertoire local. - Pour vous authentifier en tant qu'application Chat, créez des identifiants de compte de service et enregistrez-les en tant que fichier JSON nommé
credentials.json
.
- Pour vous authentifier en tant qu'utilisateur Chat, créez des identifiants d'ID client OAuth et enregistrez-les en tant que fichier JSON nommé
- <ph type="x-smartling-placeholder"></ph> Choisissez un champ d'application d'autorisation selon que vous souhaitez vous authentifier en tant qu'utilisateur Application Chat
- Un espace Google Chat dans lequel l'utilisateur authentifié ou l'application Chat appelant est membre. Pour s'authentifier en tant que l'application de chat, ajoutez l'icône Chat avec l'espace
Apps Script
- Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Créer un projet Apps Script autonome et activez le service de chat avancé.
- Dans ce guide, vous devez utiliser soit les balises user ou l'authentification des applications. Pour vous authentifier en tant qu'application Chat, créez les identifiants du compte de service. Pour connaître la marche à suivre, consultez S'authentifier et autoriser l'accès en tant qu'application Google Chat.
- Choisissez un champ d'application de l'autorisation en fonction de votre choix d'authentification en tant qu'utilisateur ou en tant qu'application Chat.
- Espace Google Chat auquel l'utilisateur authentifié ou l'application Chat appelante est membre. Pour vous authentifier en tant qu'application Chat, ajoutez l'application Chat à l'espace.
<ph type="x-smartling-placeholder">
Recevoir un message avec authentification des utilisateurs
Pour obtenir des informations sur un message avec authentification de l'utilisateur, transmettez les éléments suivants dans votre requête :
- Spécifiez le champ d'application d'autorisation
chat.messages.readonly
ouchat.messages
. - Appelez la méthode
GetMessage()
. - Définissez
name
sur le nom de ressource du message à obtenir.
L'exemple suivant reçoit un message avec une authentification de l'utilisateur :
Node.js
Python
Java
Apps Script
Pour exécuter cet exemple, remplacez les éléments suivants:
SPACE_NAME
: ID du tagname
Vous pouvez obtenir l'ID en appelant la méthodeListSpaces()
ou à partir de l'URL de l'espace.MESSAGE_NAME
: ID de l'name
du message. Vous pouvez obtenir l'ID à partir du corps de la réponse renvoyé après avoir créé un message de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.
L'API Chat renvoie une instance de
Message
qui détaille le message spécifié.
Recevoir un message avec l'authentification de l'application
Pour obtenir des informations sur un message avec authentification de l'application, transmettez les éléments suivants dans votre requête :
- Spécifiez le champ d'application de l'autorisation
chat.bot
. - Appelez la méthode
GetMessage()
. - Définissez
name
sur le nom de ressource du message à obtenir.
Dans l'exemple suivant, on reçoit un message contenant authentification de l'application:
Node.js
Python
Java
Apps Script
Pour exécuter cet exemple, remplacez les éléments suivants :
SPACE_NAME
: ID de l'name
de l'espace. Pour obtenir cet identifiant, appelez la méthodeListSpaces()
ou à partir de l'URL de l'espace.MESSAGE_NAME
: ID de l'objetname
Vous pouvez obtenir l'ID à partir du corps de la réponse renvoyé après avoir créé un message de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.
L'API Chat renvoie une instance de
Message
qui détaille le message spécifié.
Articles associés
- Mettez en forme un message.
- Supprimer un message
- Lister les messages d'un espace
- Modifier un message
- Envoyer un message.