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.