In diesem Leitfaden wird die Verwendung des
Methode get
aktiviert
SpaceEvent
Ressource des
Google Chat API, um Details zu einem Termin aus einem Google Chat-Bereich abzurufen.
Die Ressource SpaceEvent
stellt eine Änderung an einem Gruppenbereich oder seinem untergeordneten Element dar
wie Nachrichten, Reaktionen und Mitgliedschaften. Weitere Informationen
Informationen zu den unterstützten Ereignistypen finden Sie im Feld eventType
der
SpaceEvent
-Ressource
in der Referenzdokumentation.
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. Wenn beispielsweise
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.
Um diese Methode aufzurufen, müssen Sie user Authentifizierung. Um eine Ereignis handelt, muss der authentifizierte Nutzer Mitglied des Gruppenbereichs sein, in dem das Ereignis aufgetreten.
Vorbereitung
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- <ph type="x-smartling-placeholder"></ph>
Erstellen Sie OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung. Um das Beispiel in diesem
sollten Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokales Verzeichnis.
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Details zu einem Ereignis im Weltraum abrufen
So rufen Sie Details zu einem SpaceEvent
in Google Chat ab:
- Rufen Sie die Methode
get
auf. amSpaceEvent
Ressource - Übergeben Sie die
name
vonSpaceEvent
, um zu erhalten.SpaceEvent
-Namen abrufen ausSpaceEvent
Ressource von Google Chat - Mit Nutzer Authentication (Authentifizierung) Einen Autorisierungsbereich, der den Ereignistyp in Ihrer Anfrage unterstützt. Als Best Practice, wähle den restriktivsten Bereich aus, in dem deine App noch zulässig ist damit alles funktioniert.
So erhalten Sie ein SpaceEvent
mit
Nutzerauthentifizierung:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_space_event_get.py
. Fügen Sie den folgenden Code in
chat_space_event_get.py
ein:"""Gets a SpaceEvent resource 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 = ['SCOPE'] # 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() .get( # The space event to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace SPACE_EVENT with a SpaceEvent name. # Obtain the spaceEvent name from the SpaceEvent resource of # Chat API. name='spaces/SPACE/spaceEvents/SPACE_EVENT' ) .execute() ) # Prints details about the created spaceEvent. print(result)
Ersetzen Sie im Code Folgendes:
SCOPE
: Ein Autorisierungsbereich, der auf dem Ereignistyp. Wenn es sich z. B. um ein Weltraum-Event für eine neue Mitgliedschaft, verwenden Sie den Bereichchat.memberships.readonly
, Formatiert alshttps://www.googleapis.com/auth/chat.memberships.readonly
. Sie finden den Ereignistyp in derspaces.spaceEvents.list
-Methode. Informationen zur Verwendung dieser Methode finden Sie unter Ereignisse aus einem Gruppenbereich auflistenSPACE
: ein Name für den Gruppenbereich, den Sie über die Methodespaces.list
in der Chat API oder über die URL eines Gruppenbereichs.SPACE_EVENT
: der Name des Gruppenbereichs -Ereignis, das Sie im Methodespaces.spaceEvents.list
.
Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_space_event_get.py
Die Chat API gibt eine Instanz von
SpaceEvent
mit Details zum Ereignis.