Auf dieser Seite wird beschrieben, wie Sie ein Google Workspace-Abo mit
der
subscriptions.delete()
Methode löschen.
Wenn Sie ein Abo löschen, erhält 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. Informationen zum Erstellen eines Abos finden Sie unter Abo erstellen.
- Ein Apps Script-Projekt:
- Verwenden Sie Ihr Google Cloud-Projekt anstelle des Standardprojekts, das automatisch von Apps Script erstellt wird.
- Für alle Bereiche, die Sie zum Konfigurieren des OAuth-Zustimmungsbildschirms hinzugefügt haben, müssen Sie die
Bereiche auch der
appsscript.jsonDatei in Ihrem Apps Script-Projekt hinzufügen. Wenn Sie beispielsweise den Bereichchat.messagesangegeben haben, fügen Sie Folgendes hinzu: - Aktivieren
Sie den
Google Workspace Eventserweiterten Dienst.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages" ]
Erfordert die Authentifizierung und einen entsprechenden Autorisierungsbereich für jeden Ereignistyp im Abo:
- Für die Nutzerauthentifizierung ist ein Bereich erforderlich, der mindestens einen der Ereignistypen für das Abo unterstützt. Informationen zum Ermitteln eines Bereichs finden Sie unter Bereiche nach Ereignistyp.
- Für die App-Authentifizierung ist der Bereich
chat.boterforderlich (nur für Google Chat-Apps).
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 Befehlszeilenschnittstelle aus, um sie zu installieren oder zu aktualisieren:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Ein Google Workspace-Abo. Informationen zum Erstellen eines Abos finden Sie unter Abo erstellen.
Erfordert die Authentifizierung und einen entsprechenden Autorisierungsbereich für jeden Ereignistyp im Abo:
- Für die Nutzerauthentifizierung ist ein Bereich erforderlich, der mindestens einen der Ereignistypen für das Abo unterstützt. Informationen zum Ermitteln eines Bereichs finden Sie unter Bereiche nach Ereignistyp.
- Für die App-Authentifizierung ist der Bereich
chat.boterforderlich (nur für 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 Skriptdatei mit dem Namen
deleteSubscriptionund 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:
Führen Sie die Funktion
deleteSubscriptionin Ihrem Apps Script-Projekt aus, um das Abo zu löschen.
Python
Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
delete_subscription.pyund 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('credentials.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 Chat-Bereich empfängt, verwenden Siehttps://www.googleapis.com/auth/chat.spaces.readonly.SUBSCRIPTION_ID: Die ID des Abos. Sie können die ID mit einer der folgenden Methoden abrufen:
Achten Sie darauf, dass Sie die OAuth-Client-ID Anmeldedaten in Ihrem Arbeitsverzeichnis gespeichert und die Datei
credentials.jsongenannt haben. Das Codebeispiel verwendet diese JSON Datei, um sich bei Google Workspace zu authentifizieren und Nutzeranmeldedaten abzurufen. Eine Anleitung finden Sie unter Anmeldedaten mit OAuth-Client-ID erstellen.Führen Sie im Terminal Folgendes aus, um das Abo zu löschen:
python3 delete_subscription.py
Subscription Ressource enthält.