Mit dem erweiterten Google Workspace-Ereignisdienst können Sie die Google Workspace Events API in Apps Script verwenden. Mit dieser API können Sie Google Workspace-Ressourcen abonnieren, um relevante Ereignisse zu erhalten, die Sie interessieren. Ereignisse stellen Änderungen an Ressourcen dar, z. B. beim Erstellen, Aktualisieren oder Löschen von Ressourcen.
Voraussetzungen
- Ein Apps Script-Projekt, das ein Standard-Google Cloud-Projekt anstelle des von Apps Script automatisch erstellten Standardprojekts verwendet
- Ein im selben Google Cloud-Projekt erstelltes Pub/Sub-Thema, um Aboereignisse zu empfangen. Informationen zum Erstellen eines Pub/Sub-Themas finden Sie unter Pub/Sub-Thema erstellen und abonnieren.
- Wenn Sie Chat-Ereignisse abonnieren möchten, muss in der Google Cloud Console auf der Konfigurationsseite der Chat API eine Google Chat-App konfiguriert sein. Informationen zum Erstellen einer Google Chat-App finden Sie unter Google Chat-App mit Apps Script erstellen.
Die erforderlichen Autorisierungsbereiche, die der Datei
appsscript.json
des Apps Script-Projekts hinzugefügt wurden. Die erforderlichen Bereiche hängen von den Typen der Zielressourcen und -ereignisse der Abos ab. Weitere Informationen finden Sie unter Google Workspace Events API-Bereiche auswählen. Beispiel:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Referenz
Weitere Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur Google Workspace Events API. Wie alle erweiterten Dienste in Apps Script verwendet der Google Workspace-Ereignisdienst dieselben Objekte, Methoden und Parameter wie die öffentliche API.
Beispielcode
Diese Beispiele zeigen, wie Sie gängige Aktionen der Google Workspace Events API mit dem erweiterten Dienst ausführen.
Abo erstellen
Fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu, um ein Abo für eine Google Workspace-Ressource zu erstellen:
Abos auflisten
Wenn Sie Abos auflisten möchten, die nach Ereignistypen und Zielressource gefiltert sind, fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu:
Abo abrufen
Wenn Sie Informationen zu einem Abo erhalten möchten, fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu:
Abo aktualisieren
Fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu, um ein Abo zu aktualisieren oder zu verlängern:
Abo reaktivieren
Fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu, um ein Abo wieder zu aktivieren:
Abo löschen
Fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu, um ein Abo zu löschen:
Vorgang abrufen
Die meisten Google Workspace Events API-Methoden geben einen Vorgang mit langer Ausführungszeit zurück.
Sie können den Status des Vorgangs mit der Methode operations.get()
ermitteln.
Wenn Sie Informationen zu einem Vorgang abrufen möchten, fügen Sie dem Code des Apps Script-Projekts die folgende Funktion hinzu:
Verwenden Sie zum Abrufen des Namens eines Vorgangs den Wert aus dem Feld name
, der von einer der Google Workspace Events API-Methoden wie subscriptions.create()
oder subscriptions.patch()
zurückgegeben wird.