Ce guide explique comment utiliser la méthode list()
sur la ressource Message
de l'API Google Chat pour afficher une liste de messages paginée et filtrable dans un espace.
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 les fonctionnalités de 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.
- 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 Node.js.
- Créez des identifiants d'ID client OAuth pour une application de bureau. Pour exécuter l'exemple de ce guide, enregistrez les identifiants sous forme de fichier JSON nommé
client_secrets.json
dans votre répertoire local.
- Choisissez une portée d'autorisation compatible avec l'authentification des utilisateurs.
- Espace Google Chat Pour en créer un à l'aide de l'API Google Chat, consultez la section Créer un espace. Pour en créer un dans Chat : consultez le Documentation du Centre d'aide
Python
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement :
- Créez un projet Google Cloud.
- Configurez 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 Python bibliothèque cliente Cloud.
- Créez des identifiants d'ID client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre fichier dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
- Un espace Google Chat Pour en créer un à l'aide de l'API Google Chat, consultez la section Créer un espace. Pour en créer un dans Chat, consultez la documentation du centre d'aide.
Java
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement :
- 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 Java bibliothèque cliente Cloud.
- <ph type="x-smartling-placeholder"></ph>
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre fichier dans votre répertoire local.
- Choisissez une portée d'autorisation compatible avec l'authentification des utilisateurs.
- Espace Google Chat Pour en créer un à l'aide de l'API Google Chat, consultez Créez un espace. Pour en créer un dans Chat, consultez la documentation du centre d'aide.
Apps Script
- 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
- 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é.
- Choisissez une portée d'autorisation compatible avec l'authentification des utilisateurs.
- Un espace Google Chat Pour en créer un à l'aide de l'API Google Chat, consultez Créez un espace. Pour en créer un dans Chat : consultez le Documentation du Centre d'aide
Répertorier des messages
Pour répertorier les messages avec authentification des utilisateurs, 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
ListMessages()
.
L'exemple suivant liste les messages d'un espace Chat :
Node.js
Python
Java
Apps Script
Pour exécuter cet exemple, remplacez SPACE_NAME
par l'ID du champ name
de l'espace. Pour obtenir cet identifiant, appelez la méthode
ListSpaces()
ou à partir de l'URL de l'espace.
L'API Chat renvoie un
liste des messages
envoyé dans l'espace spécifié. Si la requête ne contient aucun message,
La réponse de l'API Chat renvoie un objet vide. Lorsque vous utilisez une interface REST/HTTP, la réponse contient un objet JSON vide, {}
.
Articles associés
- Mettre en forme un message
- Supprimer un message
- En savoir plus sur un message
- Modifier un message
- Envoyer un message.