本指南說明如何使用 Google Chat API 的 Section 資源中的 delete 方法,刪除 Google Chat 中的自訂版面。
刪除區段時,系統不會刪除區段中的項目 (例如聊天室),而是將這些項目移至 Google Chat 的預設區段。
只能刪除 CUSTOM_SECTION 類型的章節。詳情請參閱「在 Google Chat 中建立及管理區段」。
必要條件
Python
- 公司或企業專用 Google Workspace 帳戶,且可存取 Google Chat。
- 設定環境:
- 建立 Google Cloud 專案。
- 設定 OAuth 同意畫面。
- 啟用及設定 Google Chat API,並為 Chat 應用程式命名、設定圖示和說明。
- 安裝 Python Cloud 用戶端程式庫。
-
為電腦應用程式建立 OAuth 用戶端 ID 憑證。如要在本指南中執行範例,請將憑證儲存為名為
credentials.json的 JSON 檔案,並儲存至本機目錄。
- 選擇支援使用者驗證的授權範圍。
刪除版面
如要刪除含有使用者驗證的區段,請在要求中傳遞下列內容:
- 指定
chat.users.sections授權範圍。 - 呼叫
DeleteSection方法。 - 在要求主體中,將
name設為要刪除的章節資源名稱。
以下範例會刪除章節:
Python
from google.cloud import chat_v1
def delete_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.DeleteSectionRequest(
name="SECTION_NAME"
)
# Make the request
client.delete_section(request=request)
print("Section deleted")
如要執行這個範例,請替換下列項目:
SECTION_NAME:區段的資源名稱。您可以呼叫ListSections方法來取得資源名稱。