Method: spaces.patch

string

聊天室的資源名稱。

格式：spaces/{space}

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」。

boolean

通話使用者必須是具備管理即時通訊和聊天室對話權限的 Google Workspace 管理員。

需要 chat.admin.spaces OAuth 2.0 範圍。

管理員存取權不支援部分 FieldMask 值。詳情請參閱 updateMask 的說明。