Termine aus einem Google Chat-Bereich auflisten

In diesem Leitfaden wird die Verwendung von list erläutert. für die Ressource SpaceEvent der Google Chat API, um Änderungen an Ressourcen in einem Gruppenbereich aufzulisten.

SpaceEvent-Ressource 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 siehe eventType und payload-Felder der Ressource SpaceEvent in der Referenzdokumentation.

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

Um diese Methode aufzurufen, müssen Sie user Authentifizierung. Zum Auflisten Ereignissen aus einem Gruppenbereich muss der authentifizierte Nutzer Mitglied des Gruppenbereichs sein.

Vorbereitung

Python

  • Python 3.6 oder höher
  • Paketverwaltungstool pip
  • Die neuesten Google-Clientbibliotheken So installieren oder aktualisieren Sie sie: Führen Sie in der Befehlszeile den folgenden Befehl aus: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Weltraumereignisse auflisten

So listen Sie Gruppenbereichsereignisse aus einem Chatbereich auf:

  • Rufen Sie die Methode list auf. am SpaceEvent Ressource
  • Geben Sie die Ereignistypen an, die aufgelistet werden sollen, indem Sie die filter ein. Sie müssen mindestens einen Ereignistyp angeben. Sie können auch nach folgenden Kriterien filtern: Datum. Eine Liste der unterstützten Ereignistypen finden Sie unter eventType eingeben.
  • Mit Nutzer Authentication (Authentifizierung) einen oder mehrere Autorisierungsbereiche, um jeden Ereignistyp in Ihrer Anfrage zu unterstützen. Wählen Sie als Best Practice den restriktivsten Bereich aus, der immer noch dass Ihre App funktioniert. Informationen zum Auswählen eines Umfangs finden Sie in der Authentifizierung und Autorisierung – Übersicht

Im folgenden Codebeispiel listen Sie Ereignisse zu neuen Mitgliedschaften und Nachrichten in einem Gruppenbereich.

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_space_event_list.py.

  2. Fügen Sie den folgenden Code in chat_space_event_list.py ein:

    """Lists SpaceEvent resources from the Chat API."""

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly",
"https://www.googleapis.com/auth/chat.messages.readonly"]

# Authenticate with Google Workspace
# and get user authorization.
flow = InstalledAppFlow.from_client_secrets_file(
            'client_secrets.json', SCOPES)
creds = flow.run_local_server()

# Build a service endpoint for Chat API.
chat = build(
  'chat',
  'v1',
  credentials=creds,
)

# Use the service endpoint to call Chat API.
result = chat.spaces().spaceEvents().list(

    # The space from which to list events.
    #
    # Replace SPACE with a space name.
    # Obtain the space name from the spaces resource of Chat API,
    # or from a space's URL.
    parent='spaces/SPACE',

    # A required filter. Filters and returns events about new memberships and messages
    filter='event_types:"google.workspace.chat.membership.v1.created" OR event_types:"google.workspace.chat.message.v1.created"'

).execute()

# Prints details about the created space events.
print(result)

  3. Ersetzen Sie im Code Folgendes:

    • SPACE: ein Name für den Gruppenbereich, den Sie über die Methode spaces.list in der Chat API oder über die URL eines Gruppenbereichs.

  4. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:

    python3 chat_space_event_list.py

Die Chat API gibt eine Liste SpaceEvent Ressourcen Termine zu neuen Mitgliedschaften und Nachrichten.

Paginierung anpassen

Übergeben Sie optional die folgenden Abfrageparameter, um die Paginierung anzupassen:

  • pageSize: Die maximale Anzahl der SpaceEvent-Ressourcen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Negative Werte geben eine INVALID_ARGUMENT Fehler.
  • pageToken: Seitentoken, das von einem vorherigen Aufruf einer Gruppenbereichsereignisliste erhalten wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen. Beim Paginieren Filterwert muss mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Übergeben eines kann das zu unerwarteten Ergebnissen führen.