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-Gruppenbereich abzurufen.

Die SpaceEvent-Ressource stellt eine Änderung an einem Gruppenbereich oder seinen untergeordneten Ressourcen dar, z. B. Nachrichten, Reaktionen und Mitgliedschaften. Informationen zu den unterstützten Ereignistypen finden Sie in der Referenzdokumentation zum Feld eventType der Ressource SpaceEvent.

Sie können Ereignisse bis zu 28 Tage vor dem Zeitpunkt der Anfrage anfordern. Das Ereignis enthält die aktuelle Version der geänderten Ressource. Wenn Sie beispielsweise ein Ereignis zu einer neuen Nachricht anfordern, die Nachricht aber später aktualisiert wird, gibt der Server die aktualisierte Message-Ressource in der Ereignisnutzlast zurück.

Für den Aufruf dieser Methode ist eine Nutzerauthentifizierung erforderlich. Damit ein Ereignis abgerufen werden kann, muss der authentifizierte Nutzer Mitglied des Bereichs sein, in dem das Ereignis stattgefunden hat.

Vorbereitung

Node.js

Details zu einem Gruppenbereichsereignis abrufen

Wenn Sie Details zu einem Gruppenbereichsereignis in Google Chat abrufen möchten, übergeben Sie Folgendes in Ihrer Anfrage:

  • Geben Sie einen Autorisierungsbereich an, der den Ereignistyp in Ihrer Anfrage unterstützt. Es empfiehlt sich, den restriktivsten Bereich auszuwählen, der für die Funktion Ihrer App erforderlich ist.
  • Rufen Sie die Methode GetSpaceEvent() auf und übergeben Sie die name des abzurufenden Space-Ereignisses.

Im folgenden Beispiel wird ein Bereichsereignis 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);

Um dieses Beispiel auszuführen, ersetzen Sie Folgendes:

  • SCOPE_NAME: Ein Autorisierungsbereich basierend auf dem Ereignistyp. Wenn Sie beispielsweise ein Projektbereichsereignis 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
  • SPACE_NAME: Die ID aus dem name des Bereichs. Sie können die ID abrufen, indem Sie die Methode ListSpaces() aufrufen oder die URL des Bereichs verwenden.
  • SPACE_EVENT_NAME: die ID aus dem name des Space-Ereignisses. Sie können die ID mit der Methode ListSpaceEvents() abrufen. Informationen zur Verwendung dieser Methode

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