In diesem Leitfaden wird erläutert, wie Sie die Methode get()
für die Ressource SpaceEvent
der Google Chat API verwenden, um Details zu einem Ereignis aus einem Google Chat-Bereich abzurufen.
Die Ressource SpaceEvent
steht für eine Änderung an einem Gruppenbereich oder seinen untergeordneten Ressourcen, z. B. an Nachrichten, Reaktionen und Mitgliedschaften. Informationen zu den unterstützten Ereignistypen finden Sie im Feld eventType
der Referenzdokumentation zur Ressource SpaceEvent
.
Sie können Ereignisse bis zu 28 Tage vor dem Zeitpunkt der Anfrage anfordern. Das Ereignis
enthält die neueste Version der Ressource, die geändert wurde. Beispiel:
Sie ein Ereignis zu einer neuen Nachricht anfordern, die Nachricht jedoch später aktualisiert wurde,
-Server die aktualisierte Ressource Message
in der Ereignisnutzlast zurück.
Wenn Sie diese Methode aufrufen möchten, müssen Sie die Nutzerauthentifizierung verwenden. Damit ein Ereignis abgerufen werden kann, muss der authentifizierte Nutzer Mitglied des Gruppenbereichs sein, in dem das Ereignis stattgefunden hat.
Vorbereitung
Node.js
- Ein Google Workspace-Konto für Unternehmen oder Organisationen mit Zugriff auf Google Chat.
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Google Cloud-Clientbibliothek für Node.js.
-
OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung erstellen Wenn Sie das Beispiel in dieser Anleitung ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Details zu einem Ereignis im Weltraum abrufen
Wenn Sie Details zu einem Gruppenbereichsereignis in Google Chat abrufen möchten, geben Sie Folgendes in Ihrer Anfrage an:
- Geben Sie einen Autorisierungsbereich an, der den Ereignistyp in Ihrer Anfrage unterstützt. Es empfiehlt sich, den möglichst restriktiven Umfang auszuwählen, bei dem Ihre App weiterhin funktioniert.
- Rufen Sie die Methode
GetSpaceEvent()
auf und geben Sie diename
des zu erhaltenden Gruppenereignisses an.
Im folgenden Beispiel wird ein Gruppenbereichsereignis abgerufen:
Node.js
Ersetzen Sie Folgendes, um dieses Beispiel auszuführen:
SCOPE_NAME
: ein Autorisierungsbereich, der auf dem Ereignistyp. Wenn Sie beispielsweise ein Gruppenereignis zu einer neuen Mitgliedschaft erhalten, verwenden Sie den Bereichchat.memberships.readonly
, formatiert alshttps://www.googleapis.com/auth/chat.memberships.readonly
. Sie können den Ereignistyp über die MethodeListSpaceEvents()
abrufen. Weitere Informationen finden Sie unter Ereignisse aus einem Gruppenbereich auflisten.SPACE_NAME
: die ID aus demname
Sie erhalten die ID durch Aufrufen derListSpaces()
oder anhand der URL des Gruppenbereichs erfolgen.SPACE_EVENT_NAME
: die ID aus dem Ereignisname
Sie erhalten die ID über die MethodeListSpaceEvents()
. Weitere Informationen finden Sie unter Ereignisse aus einem Gruppenbereich auflisten.
Die Chat API gibt eine Instanz von
SpaceEvent
mit Details zum Ereignis.