Excluir uma assinatura do Google Workspace

Nesta página, explicamos como excluir uma assinatura do Google Workspace usando o método subscriptions.delete().

Quando você exclui uma assinatura, seu app não recebe mais eventos. Se uma assinatura expirar, a API Google Workspace Events a excluirá automaticamente.

Pré-requisitos

Apps Script

  • Um projeto do Apps Script:
    • Use seu projeto do Google Cloud em vez do padrão criado automaticamente pelo Apps Script.
    • Para todos os escopos adicionados ao configurar a tela de permissão OAuth, você também precisa adicionar os escopos ao arquivo appsscript.json no seu projeto do Apps Script. Por exemplo, se você especificou o escopo chat.messages, adicione o seguinte: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages"
]
    • Ative o serviço avançado do Google Workspace Events.

Python

  • Python 3.6 ou mais recente
  • A ferramenta de gerenciamento de pacotes pip
  • As bibliotecas de cliente mais recentes do Google para Python. Para instalar ou atualizar, execute o seguinte comando na interface de linha de comando: 
      pip3 install --upgrade google-api-python-client google-auth-oauthlib

Excluir uma assinatura autorizada por um usuário

O exemplo de código a seguir exclui um recurso Subscription usando a autenticação do usuário.

Para excluir uma assinatura:

Apps Script

  1. No projeto do Apps Script, crie um 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 destas opções:
      • O valor do campo uid.
      • O ID do nome do recurso representado no campo 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('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)

    Substitua:

    • SCOPE: um escopo do OAuth que aceita pelo menos um tipo de evento da assinatura. Por exemplo, se a assinatura receber eventos um espaço atualizado do Chat, https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: o ID da assinatura. Para conseguir o ID, use uma destas opções:
      • O valor do campo uid.
      • O ID do nome do recurso representado no campo 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 as credenciais de ID do cliente OAuth e nomeou o arquivo como credentials.json. O exemplo de código usa esse arquivo JSON para autenticar com o Google Workspace e receber credenciais de usuário. Para instruções, consulte Criar credenciais de ID do cliente OAuth.

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

    python3 delete_subscription.py
A API Google Workspace Events retorna uma operação de longa duração que contém a instância do recurso Subscription.