Details zum Lesestatus eines Nutzers zum Gruppenbereich abrufen

In diesem Leitfaden wird beschrieben, wie Sie mit der Methode get() für die Ressource SpaceReadState der Google Chat API Details zum Lesestatus eines Nutzers in einem Bereich abrufen. Informationen zum Abrufen des Lesestatus einer Nachricht in einem Nachrichtenverlauf finden Sie unter Details zum Lesestatus eines Nutzer-Threads abrufen.

Die SpaceReadState-Ressource ist eine Singleton-Ressource, die Details zur zuletzt gelesenen Nachricht eines bestimmten Nutzers in einem Google Chat-Gruppenbereich enthält.

Vorbereitung

Node.js

Lesestatus des Anrufers im Gruppenbereich abrufen

Wenn Sie Details zum Lesestatus eines Nutzers in einem Bereich abrufen möchten, fügen Sie Ihrer Anfrage Folgendes hinzu:

  • Geben Sie den Autorisierungsbereich chat.users.readstate oder chat.users.readstate.readonly an.
  • Rufen Sie die Methode GetSpaceReadState() auf und übergeben Sie den name des Lesestatus des Bereichs, der eine Nutzer-ID oder einen Alias und eine Bereichs-ID enthält. Das Abrufen des Lesestatus von Bereichen unterstützt nur das Abrufen des Lesestatus des anrufenden Nutzers, der durch Festlegen einer der folgenden Optionen angegeben werden kann:
    • Der Alias me. Beispiel: users/me/spaces/SPACE/spaceReadState
    • Die Google 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

Im folgenden Beispiel wird der Lesestatus des aufrufenden Nutzers für einen Bereich abgerufen:

Node.js

chat/client-libraries/cloud/get-space-read-state-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate.readonly'];

// This sample shows how to get the space read state for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState',
  };

  // Make the request
  const response = await chatClient.getSpaceReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Ersetzen Sie SPACE_NAME durch die ID aus der name des Bereichs, um dieses Beispiel auszuführen. Sie können die ID abrufen, indem Sie die Methode ListSpaces() aufrufen oder die URL des Bereichs verwenden.

Die Google Chat API ruft den angegebenen Lesestatus des Bereichs ab und gibt eine Instanz von SpaceReadState zurück.