本指南說明如何使用 Google Chat API 的 Section 資源中的 delete 方法,刪除 Google Chat 中的自訂版面。
刪除區段後,區段中的項目 (例如聊天室) 會移至 Google Chat 的預設區段,不會遭到刪除。
只能刪除 CUSTOM_SECTION 類型的章節。詳情請參閱「在 Google Chat 中建立及整理區段」。
必要條件
Python
- 具有 Google Chat 存取權的 Business 或 Enterprise 版 Google Workspace 帳戶。
- 設定環境:
- 建立 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方法來取得資源名稱。