Usuwanie subskrypcji Google Workspace

Na tej stronie wyjaśniamy, jak usunąć subskrypcję Google Workspace za pomocą subscriptions.delete() .

Gdy usuniesz subskrypcję, aplikacja nie będzie już otrzymywać żadnych zdarzeń. Jeśli wygaśnie, zostanie automatycznie usunięty przez interfejs Google Workspace Events API.

Wymagania wstępne

Google Apps Script

  • Projekt Apps Script:
    • Użyj swojego projektu Google Cloud zamiast domyślnego projektu utworzonego automatycznie przez Apps Script.
    • We wszystkich zakresach dodanych w celu skonfigurowania ekranu zgody OAuth musisz też dodać parametr ogranicza się do pliku appsscript.json w projekcie Apps Script. Na przykład: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages.readonly"
]
    • 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 języka Python. Aby je zainstalować lub zaktualizować, uruchom to w interfejsie wiersza poleceń: 
      pip3 install --upgrade google-api-python-client google-auth-oauthlib

  • subskrypcję Google Workspace. Aby je utworzyć: Więcej informacji: Tworzenie subskrypcji.

  • Wymaga uwierzytelniania:

    • Do uwierzytelniania użytkownika wymagane jest zakresu, który obsługuje co najmniej 1 typ zdarzenia w ramach subskrypcji. Informacje o zakresie znajdziesz w artykule Zakresy według typu zdarzenia.
    • Do uwierzytelniania aplikacji wymaga zakresu chat.bot (tylko aplikacje Google Chat).

Usuwanie subskrypcji autoryzowanej przez użytkownika

Poniższa próbka kodu usuwa Subscription zasób uwierzytelnianie użytkownika.

Aby usunąć subskrypcję:

Google Apps Script

  1. Utwórz nowy plik skryptu w projekcie Apps Script 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ć dowolnej z tych opcji:
      • Wartość klucza uid.
      • Identyfikator nazwy zasobu reprezentowanej w tagu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj formy płatności subscription-123.

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

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('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)

    Zastąp następujące elementy:

    • SCOPE: zakres protokołu OAuth, który obsługuje co najmniej jeden typ zdarzenia z subskrypcji. Jeśli na przykład w ramach subskrypcji otrzymujesz zdarzenia: zaktualizowany pokój czatu, https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: identyfikator subskrypcji. Aby uzyskać identyfikator, możesz użyć dowolnej z tych opcji:
      • Wartość klucza uid.
      • Identyfikator nazwy zasobu reprezentowanej w tagu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj formy płatności subscription-123.

  2. Upewnij się, że w katalogu roboczym masz zapisany identyfikator klienta OAuth dane logowania i nazwaliśmy plik client_secrets.json. Przykładowy kod korzysta z tego kodu JSON do uwierzytelniania w Google Workspace i uzyskania danych logowania użytkownika. Instrukcje: Więcej informacji: Tworzenie identyfikatora klienta OAuth dane logowania.

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

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