Google Workspace-Abo löschen

Auf dieser Seite wird erläutert, wie Sie ein Google Workspace-Abo über die subscriptions.delete() .

Wenn Sie ein Abo löschen, erhält Ihre App keine Ereignisse mehr. Wenn ein ausläuft, wird es automatisch von der Google Workspace Events API gelöscht.

Vorbereitung

Apps Script

  • Ein Apps Script-Projekt:
    • Verwenden Sie Ihr Google Cloud-Projekt anstelle des Standardprojekts, das automatisch von Apps Script.
    • Für alle Bereiche, die Sie zur Konfiguration des OAuth-Zustimmungsbildschirms hinzugefügt haben, müssen Sie auch den Bereiche auf die Datei appsscript.json in Ihrem Apps Script-Projekt. Beispiel:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Aktivieren den erweiterten Google Workspace Events-Dienst.

Python

  • Python 3.6 oder höher
  • Paketverwaltungstool pip
  • Die neuesten Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl aus, um sie zu installieren oder zu aktualisieren: Befehl in Ihrer Befehlszeile:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • Ein Google Workspace-Abo. Um eines zu erstellen, Weitere Informationen finden Sie unter Abo erstellen.

  • Erfordert eine Authentifizierung:

    • Für die Nutzerauthentifizierung ist ein Bereich, der mindestens einen Ereignistyp für das Abo unterstützt. Informationen zum Bestimmen eines Umfangs finden Sie unter Umfang nach Ereignistyp. <ph type="x-smartling-placeholder">
    • 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 ein Subscription-Ressource mithilfe der Nutzerauthentifizierung.

So löschen Sie ein Abo:

Apps Script

  1. Erstellen Sie in Ihrem Apps Script-Projekt eine neue Skriptdatei. namens 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:

    • SUBSCRIPTION_ID: Die ID des Abos. Sie können die ID so abrufen: <ph type="x-smartling-placeholder">
        </ph>
      • Der Wert der Eigenschaft <ph type="x-smartling-placeholder"></ph> uid ein.
      • Die ID des Ressourcennamens, der in der <ph type="x-smartling-placeholder"></ph> name ein. Wenn der Ressourcenname beispielsweise subscriptions/subscription-123, subscription-123 verwenden.
  2. Zum Löschen des Abos führen Sie die Funktion deleteSubscription in Ihrem Apps Script-Projekt

Python

  1. 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 Wenn Ihr Abo beispielsweise Ereignisse empfängt Der aktualisierte Chatbereich „https://www.googleapis.com/auth/chat.spaces.readonly“.
    • SUBSCRIPTION_ID: Die ID des Abos. Sie können die ID so abrufen: <ph type="x-smartling-placeholder">
        </ph>
      • Der Wert der Eigenschaft <ph type="x-smartling-placeholder"></ph> uid ein.
      • Die ID des Ressourcennamens, der in der <ph type="x-smartling-placeholder"></ph> name ein. Wenn der Ressourcenname beispielsweise subscriptions/subscription-123, subscription-123 verwenden.
  2. Speichern Sie Ihre OAuth-Client-ID in Ihrem Arbeitsverzeichnis. Anmeldedaten und den Namen client_secrets.json. Im Codebeispiel wird diese JSON-Datei verwendet, -Datei, um sich bei Google Workspace zu authentifizieren und Nutzeranmeldedaten abzurufen. Eine Anleitung dazu finden Sie Siehe OAuth-Client-ID erstellen Anmeldedaten

  3. Führen Sie in Ihrem Terminal folgenden Befehl aus, um das Abo zu löschen:

    python3 delete_subscription.py
    
Die Google Workspace Events API gibt eine lang andauernden Vorgang, enthält die Instanz der Ressource Subscription.