本頁說明如何使用 subscriptions.delete()
方法刪除 Google Workspace 訂閱方案。
刪除訂閱項目後,應用程式就不會再收到任何事件。如果訂閱項目到期,Google Workspace Events API 會自動刪除。
必要條件
Apps Script
- Google Workspace 訂閱方案。如要建立訂閱項目,請參閱「建立訂閱項目」一文。
需要使用一或多個支援訂閱項目所有事件類型的範圍進行使用者驗證。
- Apps Script 專案:
- 使用 Google Cloud 專案,而非 Apps Script 自動建立的預設專案。
- 針對您新增的所有範圍,以設定 OAuth 同意畫面,您也必須將範圍新增至 Apps Script 專案的
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 Script
在 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); }
更改下列內容:
如要刪除訂閱項目,請在 Apps Script 專案中執行
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
資源的執行個體。