Mit Terminen aus Google Chat arbeiten

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.

Beispiel dafür, wie eine Nachricht, die in einem Google Chat-Bereich gepostet wurde, ein Ereignis auslöst.
Abbildung 1. Ein Nutzer postet eine Nachricht in einem Chatbereich, der eine Message-Ressource erstellt. Google Chat erstellt dann ein Ereignis mit Daten zur neuen .

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
  • Ereignisse in Echtzeit verarbeiten oder darauf reagieren
  • Nutzer im Blick behalten Mitgliedschaftsaktivitäten und entdecke neue Gruppenbereiche, überwachen.
  • Ereignisse regelmäßig oder über einen Trigger verarbeiten oder darauf reagieren.
  • Verpasste Ereignisse aus einem Abo abrufen (aufgrund eines Ausfalls oder inaktives Abo).
API Google Workspace Events API Chat API
Quelle der Ereignisse Gruppenbereiche und Nutzer Nur Gruppenbereiche
Unterstützte Ereignisse
  • Nachrichten
  • Mitgliedschaften
  • Reaktionen
  • Leerzeichen

Eine Liste der unterstützten Ereignistypen finden Sie unter Ereignistypen zum Erstellen von Abos in der Dokumentation zur Google Workspace Events API
  • Nachrichten
  • Mitgliedschaften
  • Reaktionen
  • Leerzeichen

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.

<ph type="x-smartling-placeholder">
</ph> Chat-App, die Ereignisse über die Google Workspace Events API
Abbildung 2: Eine Chat-App empfängt Mitgliedschaftsereignisse über ein Abo mithilfe von Google Workspace Events API.

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.

Chat-App, die Ereignisse mithilfe der Chat API
Abbildung 3. A Die Chat-App empfängt aktuelle Mitgliedschaftsereignisse von Abfragen von Gruppenbereichen mit der Chat API

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