Details zu einem Termin in einem Google Chat-Bereich abrufen

In diesem Leitfaden wird erläutert, wie Sie die Methode get() für die Ressource SpaceEvent 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 Ressource, die geändert wurde. Beispiel: Sie ein Ereignis zu einer neuen Nachricht anfordern, die Nachricht jedoch später aktualisiert wurde, -Server die aktualisierte Ressource Message in der Ereignisnutzlast zurück.

Wenn Sie diese Methode aufrufen möchten, müssen Sie 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 Ereignis im Weltraum 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 Folgendes, um dieses Beispiel auszuführen:

  • SCOPE_NAME: ein Autorisierungsbereich, der auf dem Ereignistyp. 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 Sie erhalten die ID durch Aufrufen der ListSpaces() oder anhand der URL des Gruppenbereichs erfolgen.
  • SPACE_EVENT_NAME: die ID aus dem Ereignis name 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.