Auf dieser Seite wird beschrieben, wie Sie ein Google Workspace-Abo mit der Methode subscriptions.delete()
löschen.
Wenn Sie ein Abo löschen, empfängt Ihre App keine Ereignisse mehr. Wenn ein Abo abläuft, wird es von der Google Workspace Events API automatisch gelöscht.
Vorbereitung
Apps Script
- Ein Google Workspace-Abo. Wie Sie ein Abo erstellen, erfahren Sie unter Abo erstellen.
Erfordert die Nutzerauthentifizierung mit einem oder mehreren Bereichen, die alle Ereignistypen für das Abo unterstützen.
- Ein Apps Script-Projekt:
- Verwenden Sie Ihr Google Cloud-Projekt anstelle des automatisch von Apps Script erstellten Standardprojekts.
- Alle Bereiche, die Sie zum Konfigurieren des OAuth-Zustimmungsbildschirms hinzugefügt haben, müssen Sie auch der Datei
appsscript.json
in Ihrem Apps Script-Projekt hinzufügen. Beispiel: - Aktivieren Sie den erweiterten Dienst
Google Workspace Events
.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Python
- Python 3.6 oder höher
- Das Paketverwaltungstool pip
- Die neuesten Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl in der Befehlszeile aus, um sie zu installieren oder zu aktualisieren:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Ein Google Workspace-Abo. Wie Sie ein Abo erstellen, erfahren Sie unter Abo erstellen.
Authentifizierung erforderlich:
- Für die Nutzerauthentifizierung ist ein Umfang erforderlich, der mindestens einen der Ereignistypen für das Abo unterstützt. Informationen zum Identifizieren eines Gültigkeitsbereichs finden Sie unter Gültigkeitsbereich nach Ereignistyp.
- Für die App-Authentifizierung ist der Bereich
chat.bot
erforderlich (nur Google Chat-Apps).
Von einem Nutzer autorisiertes Abo löschen
Im folgenden Codebeispiel wird eine Subscription
-Ressource mithilfe der Nutzerauthentifizierung gelöscht.
So löschen Sie ein Abo:
Apps Script
Erstellen Sie in Ihrem Apps Script-Projekt eine neue Scriptdatei mit dem Namen
deleteSubscription
und fügen Sie den folgenden Code hinzu:function deleteSubscription() { // The name of the subscription to delete. const name = 'subscriptions/SUBSCRIPTION_ID'; // Call the Workspace Events API using the advanced service. const response = WorkspaceEvents.Subscriptions.remove(name); console.log(response); }
Ersetzen Sie Folgendes:
Wenn Sie das Abo löschen möchten, führen Sie die Funktion
deleteSubscription
in Ihrem Apps Script-Projekt aus.
Python
Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
delete_subscription.py
und fügen Sie den folgenden Code hinzu:"""Delete subscription.""" from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Specify required scopes. SCOPES = ['SCOPE'] # Authenticate with Google Workspace and get user authentication. flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES) CREDENTIALS = flow.run_local_server() # Call the Workspace Events API using the service endpoint. service = build( 'workspaceevents', 'v1', credentials=CREDENTIALS, ) NAME = 'subscriptions/SUBSCRIPTION_ID' response = service.subscriptions().delete(name=NAME).execute() print(response)
Ersetzen Sie Folgendes:
SCOPE
: Ein OAuth-Bereich, der mindestens einen Ereignistyp aus dem Abo unterstützt. Wenn Ihr Abo beispielsweise Ereignisse für einen aktualisierten Chatbereich erhält,https://www.googleapis.com/auth/chat.spaces.readonly
.SUBSCRIPTION_ID
: Die ID des Abos. Sie haben folgende Möglichkeiten, die ID abzurufen:
Achten Sie darauf, dass Sie Ihre Anmeldedaten für die OAuth-Client-ID in Ihrem Arbeitsverzeichnis gespeichert und die Datei
client_secrets.json
genannt haben. Im Codebeispiel wird diese JSON-Datei verwendet, um sich bei Google Workspace zu authentifizieren und Nutzeranmeldedaten abzurufen. Eine Anleitung dazu finden Sie unter Anmeldedaten mit OAuth-Client-ID erstellen.Führen Sie den folgenden Befehl in Ihrem Terminal aus, um das Abo zu löschen:
python3 delete_subscription.py
Subscription
-Ressource enthält.