Details zum Lesestatus eines Nutzers zum Gruppenbereich abrufen

In diesem Leitfaden wird erläutert, wie Sie die Methode get() für die Ressource SpaceReadState der Google Chat API verwenden, um Details zum Lesestatus eines Nutzers in einem Gruppenbereich abzurufen. Informationen zum Abrufen des Lesestatus einer Nachricht in einem Nachrichten-Thread finden Sie unter Details zum Lesestatus eines Nutzers in einem Thread abrufen.

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

Lesestatus des Anrufers für den Gruppenbereich abrufen

Wenn Sie Details zum Lesestatus eines Nutzers in einem Gruppenbereich abrufen möchten, fügen Sie Folgendes in Ihre Anfrage ein:

  • Geben Sie den chat.users.readstate- oder chat.users.readstate.readonly-Autorisierungsbereich an.
  • Rufen Sie die Methode GetSpaceReadState() auf und übergeben Sie die name des Lesestatus des Gruppenbereichs, die eine Nutzer-ID oder einen Alias und eine Gruppenbereichs-ID enthält. Beim Abrufen des Lesestatus eines Gruppenbereichs wird nur der Lesestatus des anrufenden Nutzers abgerufen. Dieser kann durch Festlegen einer der folgenden Optionen angegeben werden:
    • 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 anrufenden Nutzers. Beispiel: users/USER/spaces/SPACE/spaceReadState

Im folgenden Beispiel wird der Lesestatus des Anrufers für den Gruppenbereich 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);

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 ruft den angegebenen Lesestatus des Gruppenbereichs ab und gibt eine Instanz von SpaceReadState zurück.