Cette page explique comment les applications Google Chat peuvent recevoir des événements et y répondre dans Google Chat.
Un événement Google Chat représente une activité ou une modification dans Chat, comme l'ajout d'un message dans un espace. Votre application Chat peut utiliser des événements pour comprendre ce qui s'est passé, et agir ou répondre de manière pertinente pour vos utilisateurs.
Voici quelques exemples d'utilisation des événements:
- Surveillez les nouveaux messages dans un espace et répondez-y, par exemple en recherchant des mots clés ou des expressions.
- Envoyez un message de bienvenue aux utilisateurs lorsqu'ils rejoignent l'espace afin de leur expliquer les consignes de l'espace ou de partager des conseils sur l'utilisation efficace de l'application Chat.
- Suivez et analysez l'activité dans Chat. Par exemple, vous pouvez envoyer un rapport mensuel sur les nouveaux membres ou les messages qui reçoivent le plus de réactions ou de réponses.
- Communiquez entre différentes plates-formes de messagerie. Par exemple, les utilisateurs peuvent envoyer et recevoir des messages à partir d'une autre plate-forme de messagerie sans quitter Chat.
Fonctionnement des événements
Chaque fois qu'un événement se produit dans Google Chat, une ressource API Google Chat est créée, mise à jour ou supprimée. Les événements fournissent des informations sur le moment où l'activité s'est produite et sur la ressource d'API Chat affectée.
Chat classe les événements par type. Les types d'événements vous aident à filtrer et à ne demander que le type d'informations dont vous avez besoin. Ils vous permettent de gérer des événements similaires de la même manière.
Le tableau suivant montre l'impact d'une activité dans Chat sur une ressource d'API Chat associée et le type d'événement reçu par votre application Chat:
| Activité | Ressource de l'API Chat | Type d'événement |
|---|---|---|
Un utilisateur publie un message dans un espace Chat |
Une ressource Message est créée. |
Nouveau message |
| Un utilisateur devient gestionnaire de l'espace. | Une ressource Membership est mise à jour. |
Abonnement mis à jour |
| Un utilisateur réagit à un message. | Une ressource Reaction est créée. |
Nouvelle réaction |
| Un utilisateur quitte un espace. | Une ressource Membership est supprimée. |
Abonnement supprimé |
Recevoir des événements Google Chat
Pour recevoir des événements, votre application Chat peut effectuer l'une des opérations suivantes:
- Abonnez-vous à des événements à l'aide de l'API Google Workspace Events afin de recevoir des événements au fur et à mesure qu'ils se produisent.
- Interrogez des événements en appelant l'API Chat.
Les API Google Workspace Events et Chat sont compatibles avec les mêmes types d'événements. Pour savoir si vous devez vous abonner à des événements ou les interroger, consultez le tableau suivant:
| S'abonner à des événements | Requête pour des événements | |
|---|---|---|
| Cas d'utilisation |
|
|
| API | API Google Workspace Events | Chat API |
| Source des événements | Espaces et utilisateurs | Espaces uniquement |
| Format des événements | Un message Google Cloud Pub/Sub, formaté conformément à la spécification CloudEvent. Pour en savoir plus, consultez Structure des événements Google Workspace. |
Une ressource d'API Chat (
spaces.spaceEvent)
|
| Données d'événement | Chaîne encodée en base64 avec ou sans données de ressources. Pour obtenir des exemples de charges utiles, consultez la section Données d'événement. | Charge utile JSON contenant des données de ressource. Certains types d'événements n'incluent que certains champs de ressources. Pour obtenir des exemples de charges utiles, consultez la documentation de référence sur SpaceEvents. |
Pour savoir comment créer des abonnements à l'aide de l'API Google Workspace Events, consultez la documentation de l'API Google Workspace Events. Pour interroger des événements à l'aide de l'API Chat, consultez les guides suivants:
- Obtenir des informations sur un événement d'un espace Google Chat
- Répertorier les événements d'un espace Google Chat
Limites
-
Pour les abonnements à des utilisateurs, les événements concernant les nouveaux membres dans les messages privés ou les chats de groupe sans nom (
google.workspace.chat.membership.v1.created) ne se déclenchent qu'après la publication du premier message. - Les modifications apportées à l'historique des espaces ne déclenchent pas la mise à jour des événements d'espace (type d'événement:
google.workspace.chat.spaces.v1.updated). - Pour recevoir des événements pour les membres, l'utilisateur doit être un membre direct de l'espace. Si un utilisateur a été ajouté, mis à jour ou supprimé indirectement à un espace via un groupe Google, l'abonnement ne reçoit pas ces événements d'appartenance. Pour comprendre le fonctionnement des membres de groupes Google, consultez Ajouter un groupe Google à un espace.