Excluir uma assinatura do Google Workspace

Apps Script

• Uma assinatura do Google Workspace. Para criar um, consulte Criar uma assinatura.

• Exige autenticação do usuário com um ou mais escopos que oferecem suporte a todos os tipos de evento a assinatura.

• Um projeto do Apps Script:
  • Use seu projeto do Google Cloud em vez do projeto padrão criado automaticamente pelo Apps Script.
  • Para os escopos adicionados para configurar a tela de permissão OAuth, também é necessário adicionar o escopos para o arquivo appsscript.json no seu projeto do Apps Script. Exemplo:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • Ativar o serviço avançado Google Workspace Events.

Python

• Python 3.6 ou superior
• a ferramenta de gerenciamento de pacotes PIP;
• As bibliotecas de cliente mais recentes do Google para Python. Para instalá-los ou atualizá-los, execute o seguinte na interface de linha de comando:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• Uma assinatura do Google Workspace. Para criar um, consulte Criar uma assinatura.

• Requer autenticação:

  • Para a autenticação do usuário, exige um que ofereça suporte a pelo menos um dos tipos de evento da assinatura. Para identificar um escopo, consulte Escopos por tipo de evento.
  • Para autenticação de apps, exige o escopo chat.bot (somente apps do Google Chat).

Apps Script

1. No seu projeto do Apps Script, crie um novo arquivo de script chamado deleteSubscription e adicione o seguinte código:

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

   Substitua:

   • SUBSCRIPTION_ID: o ID da assinatura. Para conseguir o ID, use uma das seguintes opções:
     • O valor do parâmetro uid.
     • O ID do nome do recurso representado no name. Por exemplo, se o nome do recurso for subscriptions/subscription-123, use subscription-123.

2. Para excluir a assinatura, execute a função deleteSubscription no seu projeto do Apps Script.

Python

1. No diretório de trabalho, crie um arquivo chamado delete_subscription.py e adicione o seguinte código:

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

   Substitua:

   • SCOPE: um escopo do OAuth que aceite pelo menos um tipo de evento da assinatura. Por exemplo, se a assinatura receber eventos um espaço do Chat atualizado, https://www.googleapis.com/auth/chat.spaces.readonly.
   • SUBSCRIPTION_ID: o ID da assinatura. Para conseguir o ID, use uma das seguintes opções:
     • O valor do parâmetro uid.
     • O ID do nome do recurso representado no name. Por exemplo, se o nome do recurso for subscriptions/subscription-123, use subscription-123.

2. No seu diretório de trabalho, verifique se você armazenou o ID do cliente OAuth. e nomeou o arquivo client_secrets.json. O exemplo de código usa este JSON para autenticar com o Google Workspace e receber as credenciais de usuário. Para instruções, consulte Criar ID do cliente OAuth credenciais.

3. Para excluir a assinatura, execute o seguinte no seu terminal:

   python3 delete_subscription.py