In diesem Leitfaden wird die Verwendung des
update()
für die Ressource SpaceReadState
der Google Chat API, um Gruppenbereiche als
gelesen oder ungelesen.
Die Ressource SpaceReadState
ist eine Singleton-Ressource, die Details zur zuletzt gelesenen Nachricht eines bestimmten Nutzers in einem Google Chat-Gruppenbereich enthält.
Vorbereitung
Node.js
- Unternehmen Google Workspace-Konto 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, und eine Beschreibung der Chat App.
- Installieren Sie die Google Cloud-Clientbibliothek für Node.js.
-
OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung erstellen Um das Beispiel in diesem
sollten Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokales Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Lesestatus des Anrufers für den Gruppenbereich aktualisieren
Wenn Sie den Lesestatus eines Nutzers in einem Gruppenbereich aktualisieren möchten, fügen Sie Folgendes in Ihre Anfrage ein:
- Geben Sie den Autorisierungsbereich für
chat.users.readstate
an. - Rufen Sie die Methode
UpdateSpaceReadState()
auf. - Übergeben Sie
updateMask
mit dem WertlastReadTime
. - Übergeben Sie
spaceReadState
als Instanz vonSpaceReadState
Dabei gilt:- Das Feld
name
, das auf den zu aktualisierenden Lesestatus des Gruppenbereichs festgelegt ist und Folgendes enthält: Nutzer-ID oder Alias und eine ID für den Gruppenbereich. Das Aktualisieren des Lesestatus des Gruppenbereichs wird nur unterstützt des aufrufenden Nutzers aktualisiert, der durch eine der folgenden Optionen festlegen:- Der Alias für
me
. Beispiel:users/me/spaces/SPACE/spaceReadState
- Die Workspace-E-Mail-Adresse des anrufenden Nutzers. Beispiel:
users/user@example.com/spaces/SPACE/spaceReadState
- Die Nutzer-ID des aufrufenden Nutzers. Beispiel:
users/USER/spaces/SPACE/spaceReadState
- Der Alias für
- Das Feld
lastReadTime
ist auf den aktualisierten Wert der Zeit festgelegt, zu der der Lesestatus des Nutzers für den Gruppenbereich aktualisiert wurde. In der Regel entspricht dies entweder Der Zeitstempel der zuletzt gelesenen Nachricht oder ein vom Nutzer angegebener Zeitstempel um die zuletzt gelesene Position in einem Leerzeichen zu markieren. WennlastReadTime
vor Zeitpunkt der Erstellung der letzten Nachricht wird der Gruppenbereich in der Benutzeroberfläche als ungelesen angezeigt. Zum Markieren das Leerzeichen als gelesen, legen Sie fürlastReadTime
einen beliebigen Wert fest, der später (größer) als der Erstellungszeit der letzten Nachricht Der Wert vonlastReadTime
wird auf die Zeit der letzten Nachrichtenerstellung festgelegt. Der Lesestatus des Gruppenbereichs wirkt sich nur auf den Lesestatus von Nachrichten aus, die in der Unterhaltung auf oberster Ebene des Gruppenbereichs sichtbar sind. Antworten in Threads sind von diesem Zeitstempel nicht betroffen. Thread-Lesestatus.
- Das Feld
Im folgenden Beispiel wird der Lesestatus des Gruppenbereichs für den anrufenden Nutzer aktualisiert:
Node.js
Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie SPACE_NAME
durch die ID aus der name
des Gruppenbereichs.
Sie können die ID durch Aufrufen der Methode ListSpaces()
oder aus der URL des Gruppenbereichs abrufen.
Die Google Chat API aktualisiert den Lesestatus des angegebenen Gruppenbereichs und gibt
eine Instanz von
SpaceReadState
Weitere Informationen
- Lesestatus des Anrufers für den Gruppenbereich abrufen
- Rufen Sie den Thread-Lesestatus des aufrufenden Nutzers ab.