Method: spaces.patch
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新聊天室。如需範例,請參閱「更新聊天室」。
如果要更新 displayName
欄位時收到錯誤訊息 ALREADY_EXISTS
,請改用其他顯示名稱。Google Workspace 機構中的某個聊天室可能已使用這個顯示名稱。
需要使用者驗證。
HTTP 要求
PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
space.name |
string
聊天室的資源名稱。 格式:spaces/{space}
|
查詢參數
參數 |
updateMask |
string (FieldMask format)
必要欄位。更新後的欄位路徑 (如有多個路徑,以半形逗號分隔)。 你可以更新聊天室的下列欄位:
spaceDetails
displayName :僅支援針對 spaceType 欄位為 SPACE 的聊天室更新顯示名稱。如果收到 ALREADY_EXISTS 錯誤訊息,請改用其他值。Google Workspace 機構中的某個聊天室可能已使用這個顯示名稱。
spaceType :僅支援將 GROUP_CHAT 聊天室類型變更為 SPACE 。在更新遮罩中將 displayName 和 spaceType 一起加入,並確認指定的空間具有非空白的顯示名稱和 SPACE 空間類型。如果現有空間已具有 SPACE 類型,則在更新顯示名稱時,不一定要在指定空間中加入 spaceType 遮罩和 SPACE 類型。嘗試透過其他方式更新聊天室類型會導致引數無效錯誤。管理員存取權不支援「spaceType 」。
spaceHistoryState :開啟或關閉聊天室的記錄功能,更新聊天室記錄設定。只有在 Google Workspace 機構啟用記錄設定的情況下,系統支援這個選項。如要更新聊天室記錄狀態,必須省略要求中的所有其他欄位遮罩。管理員存取權不支援「spaceHistoryState 」。
accessSettings.audience :更新存取權設定,指定哪些人可以探索聊天室、加入聊天室,以及預覽已命名聊天室中的訊息 (spaceType 欄位為 SPACE )。如果現有的聊天室已有目標對象,您可以略過這個欄位遮罩的值,移除目標對象並限制空間存取權。如要更新聊天室的存取權設定,驗證的使用者必須是聊天室管理員,且會在要求中略過所有其他欄位遮罩。如果聊天室處於匯入模式,就無法更新這個欄位。詳情請參閱「將聊天室設為開放特定使用者搜尋」。管理員存取權不支援「accessSettings.audience 」。
開發人員預覽:支援變更聊天室的權限設定,支援的欄位路徑包括:permissionSettings.manage_members_and_groups 、permissionSettings.modify_space_details 、permissionSettings.toggle_history 、permissionSettings.use_at_mention_all 、permissionSettings.manage_apps 、permissionSettings.manage_webhooks 、permissionSettings.reply_messages (警告:與所有其他非權限設定欄位路徑互斥)。管理員存取權不支援「permissionSettings 」。
|
useAdminAccess |
boolean
為 true 時,此方法會使用使用者的 Google Workspace 管理員權限執行。通話使用者必須是具備管理即時通訊和聊天室對話權限的 Google Workspace 管理員。 需要 chat.admin.spaces OAuth 2.0 範圍。 管理員存取權不支援部分 FieldMask 值。詳情請參閱 updateMask 的說明。
|
回應主體
如果成功,回應主體會包含 Space
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/chat.admin.spaces
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.spaces
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-07-03 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"lastModified": "上次更新時間:2024-07-03 (世界標準時間)。",
"confidential": False
}