Method: spaces.messages.patch

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

支援下列類型的驗證：

  • 應用程式驗證 (授權範圍)：

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

  • 使用者驗證，並使用下列其中一個授權範圍：

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)

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

HTTP 要求

PATCH 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，即可在要求中指定訊息，方法是將 {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

詳情請參閱授權指南。