Auf dieser Seite wird erläutert, wie Google Chat-Apps Nachrichten empfangen und darauf antworten können Termine in Google Chat.
Ein Google Chat-Ereignis steht für eine Aktivität oder Änderung in Google Chat. z. B. eine neue Nachricht in einem Gruppenbereich. Ihre Chat-App kann Folgendes verwenden: um zu verstehen, was passiert ist, und auf diese zu reagieren für Ihre Nutzenden.
Hier einige Beispiele für die Verwendung von Ereignissen:
- Neue Nachrichten in einem Gruppenbereich überwachen und beantworten, z. B. nach Schlüssel suchen Wörter oder Wortgruppen.
- Nutzern beim Beitritt zum Gruppenbereich eine Willkommensnachricht senden, um den Gruppenbereich zu erklären oder Tipps zur effektiven Nutzung der Chat-App.
- Chataktivitäten verfolgen und analysieren Um beispielsweise eine einen monatlichen Bericht über neue Mitglieder oder Nachrichten mit den meisten Reaktionen oder Antworten.
- Kommunikation zwischen Messaging-Plattformen Nutzer können beispielsweise Nachrichten von Nutzern einer anderen Messaging-Plattform zu erhalten, ohne die Chat verlassen.
Funktionsweise von Ereignissen
Wenn in Google Chat etwas passiert, wird eine Google Chat API-Ressource erstellt, aktualisiert oder gelöscht. Google Chat nutzt Ereignisse, um Nachrichten zu senden Informationen über die Art des die aufgetretene Aktivität und die betroffene Chat API-Ressource enthält.
In Google Chat werden Ereignisse nach Typ kategorisiert. Mit Ereignistypen können Sie nur die Informationen erhalten, die Sie benötigen, und können ähnliche Aktivitäten auf die gleiche Weise.
Die folgende Tabelle zeigt, wie sich eine Aktivität in Google Chat auf einen zugehörige Chat-API-Ressource und den Ereignistyp, Die Chat-App empfängt:
Aktivität | Chat API-Ressource | Ereignistyp |
---|---|---|
Ein Nutzer postet eine Nachricht in einem Chatbereich | 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 wurde gelöscht. |
Gelöschte Mitgliedschaft |
Termine aus Google Chat empfangen
Um Termine zu empfangen, kann Ihre Chat-App eine der folgenden Aktionen ausführen: Folgendes:
- Ereignisse mit der Google Workspace Events API abonnieren, um sie zu erhalten sobald sie auftreten.
- Fragen Sie die letzten Ereignisse ab, indem Sie die Chat API aufrufen.
In der folgenden Tabelle werden der Unterschied und die Gründe für Abfragen und das Abonnieren von Veranstaltungen:
Ereignisse abonnieren | Abfragen von Ereignissen | |
---|---|---|
Anwendungsfälle |
|
|
API | Google Workspace Events API | Chat API |
Quelle der Ereignisse | Gruppenbereiche und Nutzer | Nur Gruppenbereiche |
Unterstützte Ereignisse |
Eine Liste der unterstützten Ereignistypen finden Sie unter Ereignistypen zum Erstellen von Abos in der Dokumentation zur Google Workspace Events API |
Eine Liste der unterstützten Ereignistypen finden Sie in der spaceEvents -Ressource in der Chat API
in der Referenzdokumentation.
|
Ereignisformat | Eine Google Cloud Pub/Sub-Nachricht, die gemäß dem CloudEvent-Spezifikation. Weitere Informationen finden Sie unter Struktur von Google Workspace-Terminen |
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 <ph type="x-smartling-placeholder"></ph> Referenzdokumentation. |
Beispiel: Veranstaltungen zur Mitgliedschaft in einem Gruppenbereich abfragen oder abonnieren
In diesem Beispiel möchte eine Chat-App Informationen zu Änderungen an Mitgliedern eines Chatbereichs. In Im Gruppenbereich findet die folgende Mitgliedschaftsaktivität statt:
- Ein Nutzer tritt dem Gruppenbereich bei, wodurch die Ressource
Membership
erstellt und ein neue Mitglieder ein. - Ein Nutzer wird Administrator des Gruppenbereichs und aktualisiert die
Membership
-Ressource für und löst ein aktualisiertes Mitgliedsereignis aus. - Ein Nutzer verlässt den Gruppenbereich, wodurch die Ressource
Membership
für die Nutzer und löst ein Ereignis vom Typ „Mitglied gelöscht“ aus.
Mitgliedschaftsereignisse abonnieren
Um Ereignisse in Echtzeit zu erhalten,
Die Chat-App ruft die Google Workspace Events API auf
subscriptions.create()
zum Abonnieren des Gruppenbereichs für alle Arten von Mitgliedschaftsereignissen. Nachher
Abo erstellen, kann die Chat App
Mitgliedschaftsereignisse empfangen.
In Abbildung 2 hat die Chat-App ein aktives Abo für den Gruppenbereich, sodass die App jedes Mal ein Ereignis erhält, wenn eine Mitgliedschaft im Gruppenbereich Änderungen. Die Chat-App kann dann Aktivitäten wie das Posten einer privaten Willkommensnachricht Mitglied, das dem Gruppenbereich beigetreten ist.
Weitere Informationen zum Erstellen von Abos mit der Google Workspace Events API Weitere Informationen finden Sie in der Dokumentation zur Google Workspace Events API.
Letzte Mitgliedschaftsereignisse abfragen
Anstatt die Mitgliedschaftsereignisse sofort zu erhalten, Die Chat-App kann die Chat API aufrufen, um eine Liste letzten Space-Ereignissen, die mit der Mitgliedschaftsaktivität zusammenhängen.
In Abbildung 3 wird die Chat API von einer Chat-App aufgerufen.
spaces.spaceEvents.list()
nachdem alle Mitgliedschaftsaktivitäten stattgefunden haben, und filtert die Abfrage
für neue, aktualisierte und gelöschte Mitgliedschaftsereignisse. Die Chat API gibt
Eine Liste von spaceEvent
-Ressourcen, die jede der Mitgliedschaftsänderungen darstellen.
Die Chat-App kann dann basierend auf den
Aktivitäten wie das Posten einer wöchentlichen Nachricht mit einer Zusammenfassung der
Mitgliedsaktivitäten des Gruppenbereichs in den letzten 7 Tagen.
Informationen zum Abfragen von Ereignissen mit der Chat API finden Sie unter Ereignisse aus einem Google Chat-Bereich auflisten
Beschränkungen
-
Für Abos von Nutzern, Termine zu neuen Mitgliedern in Direktnachrichten oder unbenannte Gruppenchats (
google.workspace.chat.membership.v1.created
), erst nach dem Posten der ersten Nachricht ausgelöst. - Damit der Nutzer Mitgliedschaftsereignisse erhalten kann, muss er ein direktes Mitglied des Gruppenbereichs sein. Wenn ein Nutzer hinzugefügt wurde, aktualisiert oder über eine Google-Gruppe indirekt dorthin entfernt wurde, gilt das Abo nicht diese Mitgliedschaftsereignisse erhalten. Informationen zur Funktionsweise von Google-Gruppenmitgliedschaften finden Sie unter Google-Gruppen zu Gruppenbereichen hinzufügen
Weitere Informationen
- Google Workspace Events API – Übersicht
- Abo erstellen
- Details zu einem Termin in einem Google Chat-Bereich abrufen
- Ereignisse aus einem Google Chat-Bereich auflisten
- Beispiele für die Verwendung von Ereignissen finden Sie in der Anleitung Fragen basierend auf für Chat-Unterhaltungen mit Gemini-KI Chat-App oder die Inklusivitätshilfe des Chat-App im Codelab Apps für Google Chat mit Gemini erstellen