Usuwanie subskrypcji Google Workspace

Z tej strony dowiesz się, jak usunąć abonament Google Workspace za pomocą metody subscriptions.delete().

Gdy usuniesz subskrypcję, Twoja aplikacja nie będzie już otrzymywać żadnych zdarzeń. Jeśli subskrypcja wygaśnie, interfejs Google Workspace Events API usunie ją automatycznie.

Wymagania wstępne

Apps Script

  • Projekt Apps Script:
    • Zamiast domyślnego projektu utworzonego automatycznie przez Apps Script użyj projektu Google Cloud.
    • Wszystkie zakresy dodane do skonfigurowania ekranu akceptacji OAuth musisz też dodać do zakresów w pliku appsscript.json w projekcie Apps Script. Jeśli na przykład określisz zakres chat.messages, dodaj te elementy: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages"
]
    • Włącz usługę zaawansowaną Google Workspace Events.

Python

  • Python w wersji 3.6 lub nowszej
  • Narzędzie do zarządzania pakietami pip
  • Najnowsze biblioteki klienta Google dla Pythona. Aby je zainstalować lub zaktualizować, w interfejsie wiersza poleceń uruchom to polecenie: 
      pip3 install --upgrade google-api-python-client google-auth-oauthlib

Usuwanie subskrypcji autoryzowanej przez użytkownika

Ten przykład kodu usuwa zasób Subscription za pomocą uwierzytelniania użytkownika.

Aby usunąć subskrypcję:

Apps Script

  1. W projekcie Apps Script utwórz nowy plik skryptu o nazwie deleteSubscription i dodaj ten kod:

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

    Zastąp następujące elementy:

    • SUBSCRIPTION_ID: identyfikator subskrypcji. Aby uzyskać identyfikator, możesz użyć dowolnego z tych elementów:
      • Wartość pola uid.
      • Identyfikator nazwy zasobu reprezentowany w polu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj subscription-123.

  2. Aby usunąć subskrypcję, w projekcie Apps Script uruchom funkcję deleteSubscription.

Python

  1. W katalogu roboczym utwórz plik o nazwie delete_subscription.py i dodaj ten kod:

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

    Zastąp następujące elementy:

    • SCOPE: zakres OAuth, który obsługuje co najmniej 1 typ zdarzenia z subskrypcji. Jeśli na przykład subskrypcja otrzymuje zdarzenia zaktualizowanego pokoju Google Chat, użyj zakresu https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: identyfikator subskrypcji. Aby uzyskać identyfikator, możesz użyć dowolnego z tych elementów:
      • Wartość pola uid.
      • Identyfikator nazwy zasobu reprezentowany w polu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj subscription-123.

  2. W katalogu roboczym upewnij się, że masz zapisane dane logowania identyfikatora klienta OAuth i że plik ma nazwę credentials.json. Ten przykład kodu używa tego pliku JSON do uwierzytelniania w Google Workspace i uzyskiwania danych logowania użytkownika. Instrukcje znajdziesz w artykule Tworzenie danych logowania identyfikatora klienta OAuth.

  3. Aby usunąć subskrypcję, w terminalu uruchom to polecenie:

    python3 delete_subscription.py
Interfejs Google Workspace Events API zwraca długo trwającą operację, która zawiera instancję zasobu Subscription.