Eliminare un abbonamento a Google Workspace

In questa pagina viene spiegato come eliminare un abbonamento a Google Workspace utilizzando: subscriptions.delete() .

Quando elimini un abbonamento, la tua app non riceve più eventi. Se scade, l'API Google Workspace Events lo elimina automaticamente.

Prerequisiti

Apps Script

  • Un progetto Apps Script:
    • Usa il tuo progetto Google Cloud invece di quello predefinito creato automaticamente Apps Script.
    • Per tutti gli ambiti che hai aggiunto per configurare la schermata per il consenso OAuth, devi aggiungere anche ambiti al file appsscript.json nel tuo progetto Apps Script. Ad esempio:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Attiva il servizio avanzato Google Workspace Events.

Python

  • Python 3.6 o versioni successive
  • Lo strumento di gestione dei pacchetti pip
  • Le librerie client di Google più recenti per Python. Per installarle o aggiornarle, esegui questo comando nell'interfaccia a riga di comando:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • Un abbonamento a Google Workspace. Per crearne uno, consulta Creare un abbonamento.

  • Richiede autenticazione:

    • Per l'autenticazione utente, richiede un che supporti almeno uno dei tipi di eventi per la sottoscrizione. Per identificare un ambito, consulta Ambiti per tipo di evento.
    • Per l'autenticazione delle app, è richiesto l'ambito chat.bot (solo app Google Chat).

Eliminare un abbonamento autorizzato da un utente

Il seguente esempio di codice elimina un Subscription risorsa mediante l'autenticazione utente.

Per eliminare una sottoscrizione:

Apps Script

  1. Nel tuo progetto Apps Script, crea un nuovo file di script denominato deleteSubscription e aggiungi il seguente codice:

    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);
    }
    

    Sostituisci quanto segue:

    • SUBSCRIPTION_ID: l'ID dell'abbonamento. Per ottenere l'ID, puoi utilizzare uno dei seguenti metodi:
      • Il valore del parametro uid.
      • L'ID del nome della risorsa rappresentato nell' name. Ad esempio, se il nome della risorsa è subscriptions/subscription-123, usa subscription-123.
  2. Per eliminare la sottoscrizione, esegui la funzione deleteSubscription nel progetto Apps Script.

Python

  1. Nella directory di lavoro, crea un file denominato delete_subscription.py e aggiungi il seguente codice:

    """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)
    

    Sostituisci quanto segue:

    • SCOPE: un ambito OAuth che supporta almeno un tipo di evento della sottoscrizione. Ad esempio, se l'abbonamento riceve eventi uno spazio di Chat aggiornato, https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: l'ID dell'abbonamento. Per ottenere l'ID, puoi utilizzare uno dei seguenti metodi:
      • Il valore del parametro uid.
      • L'ID del nome della risorsa rappresentato nell' name. Ad esempio, se il nome della risorsa è subscriptions/subscription-123, usa subscription-123.
  2. Nella directory di lavoro, assicurati di aver archiviato il tuo ID client OAuth credenziali e denominato client_secrets.json. L'esempio di codice utilizza questo JSON per eseguire l'autenticazione con Google Workspace e ottenere le credenziali utente. Per istruzioni, consulta la sezione Creare un ID client OAuth credenziali.

  3. Per eliminare la sottoscrizione, esegui questo comando nel terminale:

    python3 delete_subscription.py
    
L'API Google Workspace Events restituisce un un'operazione a lunga esecuzione contiene l'istanza della risorsa Subscription.