Auf dieser Seite wird erläutert, wie Google Chat-Apps Ereignisse in Google Chat empfangen und darauf antworten können.
Ein Google Chat-Ereignis steht für eine Aktivität oder Änderung in Chat, z. B. eine neue Nachricht in einem Gruppenbereich. Ihre Chat-App kann Ereignisse verwenden, um nachzuvollziehen, was passiert ist, und entsprechend zu reagieren oder auf sinnvolle Weise für Ihre Nutzer zu reagieren.
Hier sind einige Beispiele für die Verwendung von Ereignissen:
- Neue Nachrichten in einem Gruppenbereich überwachen und beantworten, z. B. nach Schlüsselwörtern oder Sätzen.
- Senden Sie den Nutzern eine Willkommensnachricht, wenn sie dem Gruppenbereich beitreten, um die Richtlinien für den Gruppenbereich zu erläutern oder Tipps zur effektiven Nutzung der Chat-App zu geben.
- Sie können die Chataktivität verfolgen und analysieren. Sie können z. B. einen monatlichen Bericht über neue Mitglieder oder die Nachrichten senden, die die meisten Reaktionen oder Antworten erhalten.
- Kommunikation zwischen Messaging-Plattformen Beispielsweise können Nutzer Nachrichten von einer anderen Messaging-Plattform senden und von Nutzern empfangen, ohne Chat zu verlassen.
Funktionsweise von Ereignissen
Wenn in Google Chat etwas passiert, wird eine Google Chat API-Ressource erstellt, aktualisiert oder gelöscht. Ereignisse liefern Informationen darüber, wann die Aktivität stattgefunden hat, und über die betroffene Chat API-Ressource.
In Chat werden Ereignisse nach Typ kategorisiert. Mithilfe von Ereignistypen können Sie nur die benötigten Informationen filtern und anfordern und ähnliche Ereignisse auf die gleiche Weise verarbeiten.
Die folgende Tabelle zeigt, wie sich eine Aktivität in Chat auf eine zugehörige Chat API-Ressource auswirkt und welche Art von Ereignis Ihre Chat-App empfängt:
| Aktivitäten | Chat API-Ressource | Ereignistyp |
|---|---|---|
Ein Nutzer postet eine Nachricht in einem Gruppenbereich von „Chat“ |
Eine Message-Ressource wird erstellt. |
Neue Nachricht |
| Ein Nutzer wird zum Administrator des Gruppenbereichs. | Eine Membership-Ressource wird aktualisiert. |
Mitgliedschaft aktualisiert |
| Ein Nutzer reagiert auf eine Nachricht. | Eine Reaction-Ressource wird erstellt. |
Neue Reaktion |
| Ein Nutzer verlässt einen Gruppenbereich. | Eine Membership-Ressource wird gelöscht. |
Gelöschte Mitgliedschaft |
Termine aus Google Chat empfangen
Zum Empfangen von Ereignissen kann Ihre Chat-App eine der folgenden Aktionen ausführen:
- Abonnieren Sie Ereignisse mit der Google Workspace Events API, um Ereignisse zu empfangen, sobald sie auftreten.
- Fragen Sie Ereignisse durch Aufrufen der Chat API ab.
Die Google Workspace Events API und die Chat API unterstützen und liefern dieselben Ereignistypen. In der folgenden Tabelle sehen Sie, ob Sie Ereignisse abonnieren oder abfragen sollten:
| Ereignisse abonnieren | Ereignisse abfragen | |
|---|---|---|
| Anwendungsfälle |
|
|
| API | Google Workspace Events API | Chat API |
| Ereignisquelle | Gruppenbereiche und Nutzer | Nur Gruppenbereiche |
| Ereignisformat | Eine Google Cloud Pub/Sub-Nachricht, die gemäß der CloudEvent-Spezifikation formatiert ist. Weitere Informationen finden Sie unter Struktur von Google Workspace-Ereignissen. |
Eine Chat API-Ressource (
spaces.spaceEvent)
|
| Ereignisdaten | Base64-codierter String mit oder ohne Ressourcendaten. Beispiele für Nutzlasten finden Sie unter Ereignisdaten. | JSON-Nutzlast, die Ressourcendaten enthält. Einige Ereignistypen enthalten nur bestimmte Ressourcenfelder. Beispiele für Nutzlasten finden Sie in der Referenzdokumentation zu SpaceEvents. |
Informationen zum Erstellen von Abos mit der Google Workspace Events API finden Sie in der Dokumentation zur Google Workspace Events API. Informationen zum Abfragen von Ereignissen mithilfe der Chat API finden Sie in den folgenden Leitfäden:
- Details zu Terminen in einem Google Chat-Bereich abrufen
- Termine aus einem Google Chat-Bereich auflisten
Beschränkungen
-
Bei Abos von Nutzern werden Ereignisse zu neuen Mitgliedern in Direktnachrichten oder unbenannten Gruppenchats (
google.workspace.chat.membership.v1.created) erst ausgelöst, nachdem die erste Nachricht gepostet wurde. - Änderungen am Gruppenbereichsverlauf lösen keine aktualisierten Gruppenbereichsereignisse aus (Ereignistyp:
google.workspace.chat.spaces.v1.updated). - Um Mitgliedschaften zu empfangen, muss der Nutzer ein direktes Mitglied des Gruppenbereichs sein. Wenn ein Nutzer über eine Google-Gruppe indirekt einem Gruppenbereich hinzugefügt, aktualisiert oder entfernt wurde, werden diese Mitgliedschaftsereignisse nicht an das Abo gesendet. Informationen zur Funktionsweise von Google-Gruppenmitgliedschaften finden Sie unter Google-Gruppe zu einem Gruppenbereich hinzufügen.