Method: spaces.messages.update

更新訊息。patchupdate 方法有所不同。patch 方法會使用 patch 要求,update 方法則使用 put 要求。建議您使用 patch 方法。如需範例,請參閱「更新訊息」。

支援以下類型的驗證

使用應用程式驗證時,要求只能更新由呼叫的 Chat 應用程式建立的訊息。

HTTP 要求

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

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

路徑參數

參數
message.name

string

ID。訊息的資源名稱。

格式: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 必須為client-assigned,否則要求失敗。

要求主體

要求主體包含 Message 的例項。

回應主體

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

授權範圍

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

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

詳情請參閱授權指南