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 in der Referenzdokumentation zur Ressource SpaceEvent im Feld eventType.

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 zu einer neuen Nachricht anfordern, die Nachricht jedoch später aktualisiert wurde, gibt der 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 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 übergeben Sie die name des zu erhaltenden Gruppenereignisses.

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: 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. Informationen zur Verwendung dieser Methode finden Sie unter Ereignisse aus einem Gruppenbereich auflisten.
  • SPACE_NAME: die ID aus dem name des Gruppenbereichs. Sie erhalten die ID durch Aufrufen der Methode ListSpaces() oder über die URL des Bereichs.
  • 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.