Method: spaces.messages.patch

更新訊息。patch 和 update 方法之間有差異。patch 方法會使用 patch 要求，而 update 方法使用 put 要求。建議您使用 patch 方法。如需範例，請參閱「更新訊息」。

必須完成驗證。支援應用程式驗證和使用者驗證。使用應用程式驗證功能時，要求只能更新由呼叫 Chat 應用程式建立的訊息。

HTTP 要求

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

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

路徑參數

參數
message.name

string

訊息的資源名稱。

格式︰spaces/{space}/messages/{message}

其中 {space} 是張貼訊息的聊天室 ID，{message} 則是系統為該訊息指派的 ID。例如：spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB。

如果您在建立訊息時設定了自訂 ID，即可使用這個 ID 在要求中指定訊息，只要將 {message} 替換成 clientAssignedMessageId 欄位的值即可。例如 spaces/AAAAAAAAAAA/messages/client-custom-name。詳情請參閱為訊息命名。

查詢參數

參數
updateMask

string (FieldMask format)

必要欄位。要更新的欄位路徑。請以半形逗號分隔不同的值，或使用 * 更新所有欄位路徑。

目前支援的欄位路徑：
allowMissing

boolean

選用設定。如果找不到 true 和這類訊息，系統會建立新訊息並忽略 updateMask。指定的訊息 ID 必須是用戶端指派，否則要求失敗。

要求主體

要求主體包含 Message 的例項。

回應主體

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

授權範圍

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

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

詳情請參閱授權指南。