Details zu einem Termin in einem Google Chat-Bereich abrufen

In diesem Leitfaden wird erläutert, wie Sie die Methode get() für die SpaceEvent-Ressource 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 geänderten Ressource. Wenn Sie beispielsweise ein Ereignis für eine neue Nachricht anfordern, die Nachricht aber später aktualisiert wurde, gibt der Server die aktualisierte Message-Ressource in der Ereignisnutzlast zurück.

Um diese Methode aufzurufen, musst du 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

Details zu einem Weltraumereignis 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 die name des zu erhaltenden Gruppenereignisses an.

Im folgenden Beispiel wird ein Gruppenbereichsereignis abgerufen:

Node.js

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

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event 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 and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME'
  };

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

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

main().catch(console.error);

Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:

  • SCOPE_NAME: einen Autorisierungsbereich, der auf dem Ereignistyp basiert. Wenn Sie beispielsweise ein Gruppenereignis zu einer neuen Mitgliedschaft erhalten, verwenden Sie den Bereich chat.memberships.readonly, formatiert als https://www.googleapis.com/auth/chat.memberships.readonly. Sie können den Ereignistyp über die Methode ListSpaceEvents() abrufen. Weitere Informationen finden Sie unter Ereignisse aus einem Gruppenbereich auflisten.
  • SPACE_NAME: die ID aus dem name des Gruppenbereichs. Sie können die ID durch Aufrufen der Methode ListSpaces() oder aus der URL des Gruppenbereichs abrufen.
  • SPACE_EVENT_NAME: die ID aus dem name des Weltraumereignisses. Sie erhalten die ID über die Methode ListSpaceEvents(). Weitere Informationen finden Sie unter Ereignisse aus einem Gruppenbereich auflisten.

Die Chat API gibt eine Instanz von SpaceEvent mit Details zum Ereignis zurück.