Ce guide explique comment utiliser le
delete()
sur la ressource Message
de l'API Google Chat pour supprimer un texte ou une fiche
.
Dans l'API Chat, un message Chat est représenté par la 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.
Avec l'authentification des applications, vous pouvez utiliser cette méthode pour supprimer un message Application Chat envoyée. Avec l'authentification des utilisateurs, vous pouvez utiliser cette méthode pour supprimer un message envoyé par l'utilisateur authentifié. Si l'utilisateur est gestionnaire de l'espace, vous pouvez également supprimer un envoyé par les autres membres de l'espace. Pour en savoir plus, consultez En savoir plus sur votre rôle de gestionnaire de l'espace.
Prérequis
Node.js
- Compte Google Workspace Business ou Enterprise 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 Node.js.
- Créez des identifiants d'accès en fonction de la méthode d'authentification que vous souhaitez utiliser dans votre requête API Google Chat :
- 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é
- 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.
Python
- Une entreprise Un compte Google Workspace 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 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 de Chat,
créer un ID client OAuth
identifiants et enregistrez-les dans un 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 de Chat,
créer un ID client OAuth
identifiants et enregistrez-les dans un fichier JSON nommé
- 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.
Java
- Compte Google Workspace Business ou Enterprise 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 de Chat,
créer un ID client OAuth
identifiants et enregistrez-les dans un 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 de Chat,
créer un ID client OAuth
identifiants et enregistrez-les dans un fichier JSON nommé
- 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.
Apps Script
- 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.
- Créer un projet Apps Script autonome et activez le service de chat avancé.
- Dans ce guide, vous devez utiliser l'authentification des utilisateurs ou des applications. Pour vous authentifier en tant qu'application Chat, créez des identifiants de 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.
<ph type="x-smartling-placeholder">
Supprimer un message avec authentification utilisateur
Pour supprimer un message avec l'authentification de l'utilisateur, procédez comme suit : transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application de l'autorisation
chat.messages
. - Appelez la méthode
DeleteMessage()
. - Définissez
name
sur le nom de ressource du message à supprimer.
L'exemple suivant supprime un message contenant 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
Pour obtenir cet identifiant, appelez 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éé une de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.
Si la requête aboutit, le corps de la réponse est vide, ce qui indique que le message est supprimés.
Supprimer un message avec l'authentification par application
Pour supprimer un message avec une authentification d'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
DeleteMessage()
. - Définissez
name
sur le nom de la ressource du message à supprimer.
L'exemple suivant supprime un message avec une authentification d'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. Vous pouvez obtenir l'ID en appelant 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éé une de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.
Si la requête aboutit, le corps de la réponse est vide, ce qui indique que le message est supprimé.
Articles associés
- Mettre en forme un message
- Obtenir des informations sur un message
- Répertoriez les messages d'un espace.
- Mettez à jour un message.
- Envoyer un message.