Method: spaces.patch

更新聊天室。如需範例，請參閱「更新聊天室」。需要使用者驗證和 chat.spaces 範圍。

HTTP 要求

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
space.name

string

聊天室的資源名稱。

格式︰spaces/{space}

查詢參數

參數
updateMask

string (FieldMask format)

必要欄位。更新的欄位路徑 (如有多個欄位，請以半形逗號分隔)。

目前支援的欄位路徑：

  • displayName (僅支援變更 SPACE 類型的聊天室顯示名稱，或一併加入 spaceType 遮罩，將 GROUP_CHAT 聊天室類型變更為 SPACE。嘗試更新 GROUP_CHAT 或 DIRECT_MESSAGE 空格的顯示名稱會導致引數無效。)

  • spaceType (僅支援將 GROUP_CHAT 聊天室類型變更為 SPACE)。在更新遮罩中納入 displayName 和 spaceType，並確保指定聊天室含有非空白的顯示名稱和 SPACE 聊天室類型。如果現有空間已有 SPACE 類型，則在更新顯示名稱時納入 spaceType 遮罩和 SPACE 類型。如果以其他方式更新聊天室類型，會導致引數無效。

  • spaceDetails

  • spaceHistoryState (如果機構允許使用者變更自己的記錄設定，則支援開啟或關閉聊天室記錄功能)。警告：與所有其他欄位路徑完全互斥)。

要求主體

要求主體包含 Space 的例項。

回應主體

如果成功，回應主體會包含 Space 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

詳情請參閱授權指南。