本页面介绍了如何使用 subscriptions.delete()
方法删除 Google Workspace 订阅。
删除订阅后,您的应用将不再接收任何事件。如果订阅过期,Google Workspace Events API 会自动将其删除。
前提条件
Apps 脚本
- Google Workspace 订阅。如需创建订阅,请参阅创建订阅。
需要用户通过一个或多个支持订阅的所有事件类型的范围进行身份验证。
- Apps 脚本项目:
- 使用您的 Google Cloud 项目,而不是 Apps 脚本自动创建的默认项目。
- 对于您为配置 OAuth 权限请求页面而添加的所有范围,您还必须将这些范围添加到 Apps 脚本项目中的
appsscript.json
文件中。 例如,如果您指定了chat.messages
范围,请添加以下内容: - 启用
Google Workspace Events
高级服务。
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages" ]
Python
- Python 3.6 或更高版本
- pip 软件包管理工具
- 适用于 Python 的最新 Google 客户端库。如需安装或更新这些软件包,请在命令行界面中运行以下命令:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Google Workspace 订阅。如需创建订阅,请参阅创建订阅。
需要身份验证:
- 对于用户身份验证,需要一个支持订阅的至少一种事件类型的范围。如需确定范围,请参阅按事件类型划分的范围。
- 对于应用身份验证,需要
chat.bot
范围(仅限 Google Chat 应用)。
删除用户授权的订阅
以下代码示例使用用户身份验证删除 Subscription
资源。
如需删除订阅,请执行以下操作:
Apps 脚本
在您的 Apps 脚本项目中,创建一个名为
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); }
替换以下内容:
如需删除订阅,请在您的 Apps 脚本项目中运行函数
deleteSubscription
。
Python
在工作目录中,创建一个名为
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 范围。例如,如果您的订阅接收到更新后的 Chat 聊天室的事件,则为https://www.googleapis.com/auth/chat.spaces.readonly
。SUBSCRIPTION_ID
:订阅的 ID。如需获取 ID,您可以使用以下任一方法:
在工作目录中,确保您已存储 OAuth 客户端 ID 凭据,并将该文件命名为
credentials.json
。此代码示例使用此 JSON 文件向 Google Workspace 进行身份验证并获取用户凭据。有关说明,请参阅创建 OAuth 客户端 ID 凭证。如需删除订阅,请在终端中运行以下命令:
python3 delete_subscription.py
Subscription
资源的实例。