Удаление подписки на Google Workspace

На этой странице объясняется, как удалить подписку Google Workspace с помощью метода subscriptions.delete() .

При удалении подписки ваше приложение больше не получает никаких событий. Если срок действия подписки истекает, API событий Google Workspace автоматически удаляет её.

Предварительные требования

Apps Script

  • Проект на Apps Script:
    • Используйте свой проект Google Cloud вместо проекта, автоматически создаваемого Apps Script по умолчанию.
    • Для всех областей действия (scopes), которые вы добавили для настройки экрана согласия OAuth, необходимо также добавить эти области в файл appsscript.json в вашем проекте Apps Script. Например, если вы указали область действия chat.messages , добавьте следующее: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages"
]
    • Включите расширенную службу « Google Workspace Events .

Python

  • Python 3.6 или выше
  • Инструмент управления пакетами pip
  • Новейшие клиентские библиотеки Google для Python. Для их установки или обновления выполните следующую команду в командной строке: 
      pip3 install --upgrade google-api-python-client google-auth-oauthlib

Удалить подписку, авторизованную пользователем.

Приведенный ниже пример кода удаляет ресурс Subscription с использованием аутентификации пользователя.

Чтобы отменить подписку:

Apps Script

  1. В проекте Apps Script создайте новый файл скрипта с именем deleteSubscription и добавьте следующий код:

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

    Замените следующее:

    • SUBSCRIPTION_ID : Идентификатор подписки. Чтобы получить идентификатор, можно использовать любой из следующих способов:
      • Значение поля uid .
      • Идентификатор имени ресурса, представленного в поле name . Например, если имя ресурса — subscriptions/subscription-123 , используйте subscription-123 .

  2. Чтобы удалить подписку, запустите функцию deleteSubscription в вашем проекте Apps Script.

Python

  1. В рабочей директории создайте файл с именем delete_subscription.py и добавьте в него следующий код:

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

    Замените следующее:

    • SCOPE : Область действия OAuth, поддерживающая как минимум один тип событий из подписки . Например, если ваша подписка получает события обновления пространства чата, https://www.googleapis.com/auth/chat.spaces.readonly .
    • SUBSCRIPTION_ID : Идентификатор подписки. Чтобы получить идентификатор, можно использовать любой из следующих способов:
      • Значение поля uid .
      • Идентификатор имени ресурса, представленного в поле name . Например, если имя ресурса — subscriptions/subscription-123 , используйте subscription-123 .

  2. В рабочей директории убедитесь, что вы сохранили учетные данные клиента OAuth и назвали файл credentials.json . В примере кода этот JSON-файл используется для аутентификации в Google Workspace и получения учетных данных пользователя. Инструкции см. в разделе «Создание учетных данных клиента OAuth» .

  3. Чтобы удалить подписку, выполните в терминале следующую команду:

    python3 delete_subscription.py
API событий Google Workspace возвращает длительную операцию , содержащую экземпляр ресурса Subscription .