Termine aus einem Google Chat-Bereich auflisten

In diesem Leitfaden wird beschrieben, wie Sie die Methode list() für die Ressource SpaceEvent der Google Chat API verwenden, um Änderungen an Ressourcen in einem Gruppenbereich aufzulisten.

Die Ressource SpaceEvent stellt eine Änderung am Zielbereich dar, einschließlich der untergeordneten Ressourcen des Bereichs wie Nachrichten, Reaktionen und Mitgliedschaften. Weitere Informationen zur Liste der unterstützten Ereignistypen und Ereignisnutzlasten finden Sie in den Feldern eventType und payload der Referenzdokumentation für die SpaceEvent-Ressource.

Sie können Ereignisse bis zu 28 Tage vor dem Zeitpunkt der Anfrage auflisten. Der Server gibt Ereignisse zurück, die die neueste Version der betroffenen Ressource enthalten. Wenn Sie beispielsweise Ereignisse zu neuen Mitgliedern eines Gruppenbereichs auflisten, gibt der Server Membership-Ressourcen zurück, die die neuesten Mitgliedschaftsdetails enthalten. Wenn im angeforderten Zeitraum neue Mitglieder entfernt wurden, enthält die Ereignisnutzlast eine leere Membership-Ressource.

Für den Aufruf dieser Methode müssen Sie die Nutzerauthentifizierung verwenden. Um Ereignisse aus einem Gruppenbereich aufzulisten, muss der authentifizierte Nutzer Mitglied des Gruppenbereichs sein.

Vorbereitung

Node.js

Space-Ereignisse auflisten

Wenn Sie Gruppenbereichsereignisse aus einem Chatbereich auflisten möchten, geben Sie Folgendes in Ihrer Anfrage an:

  • Geben Sie einen oder mehrere Autorisierungsbereiche an, um jeden Ereignistyp in Ihrer Anfrage zu unterstützen. Wählen Sie als Best Practice den restriktivsten Bereich aus, in dem Ihre Anwendung noch funktioniert. Informationen zum Auswählen eines Bereichs finden Sie in der Übersicht zu Authentifizierung und Autorisierung.

  • Rufen Sie die Methode ListSpaceEvents() auf und übergeben Sie die filter der Ereignistypen, die aufgelistet werden sollen. Sie müssen mindestens einen Ereignistyp angeben. Außerdem können Sie nach Datum filtern. Eine Liste der unterstützten Ereignistypen finden Sie im Feld eventType der Referenzdokumentation zur SpaceEvent-Ressource.

Im folgenden Beispiel sind Ereignisse zu neuen Mitgliedschaften und Nachrichten in einem Gruppenbereich aufgeführt:

Node.js

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

// Authorization scopes based on the event types
const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.memberships.readonly',
  'https://www.googleapis.com/auth/chat.messages.readonly'
];

// This sample shows how to list space events with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    parent: 'spaces/SPACE_NAME',
    // A required filter. Filters events about new memberships and messages
    filter: 'eventTypes:"google.workspace.chat.membership.v1.created" OR eventTypes:"google.workspace.chat.message.v1.created"'
  };

  // Make the request
  const pageResult = chatClient.listSpaceEventsAsync(request);

  // Handle the response. Iterating over pageResult will yield results and
  // resolve additional pages automatically.
  for await (const response of pageResult) {
    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 Chat API gibt eine paginierte Liste der Gruppenbereichsereignisse zu neuen Mitgliedschaften und Nachrichten zurück.