Method: spaces.messages.create

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立訊息。如需使用範例，請參閱建立訊息。

需要驗證。完整支援服務帳戶驗證。

支援使用者驗證，這是 Google Workspace 開發人員預覽計劃的一部分，可讓使用者搶先體驗特定功能。使用者驗證需要 chat.messages 或 chat.messages.create 授權範圍。

Chat 會在註冊 Webhook 時產生的網址提供 Webhook 驗證，因此 Webhook 可在沒有服務帳戶或使用者驗證的情況下建立訊息。

HTTP 要求

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

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

路徑參數

參數
parent

string

必要欄位。要建立訊息的聊天室資源名稱。

格式：空格/{空格}

查詢參數

參數
threadKey
(deprecated)

string

選填欄位，已淘汰：請改用 thread.thread_key。不透明執行緒 ID。如要開始新增或新增至執行緒，請建立訊息並指定 threadKey 或 thread.name。如需使用範例，請參閱開始或回覆郵件串。
requestId

string

選填欄位，這則訊息的專屬要求 ID。指定現有要求 ID 會傳回使用該 ID 建立的訊息，而非建立新訊息。
messageReplyOption

enum (MessageReplyOption)

選填欄位，指定要將郵件發起對話串或回覆討論串。僅適用於已命名的聊天室。
messageId

string

選填欄位，在建立訊息時指派的 Chat 訊息自訂名稱。開頭必須是 client-，且只能包含小寫英文字母、數字和連字號，長度上限為 63 個字元。指定這個欄位，即可取得、更新或刪除具有指定值的訊息。如需使用範例，請參閱為已建立的郵件命名一文。

要求主體

要求主體包含 Message 的例項。

回應主體

如果成功，回應主體會包含新建立的 Message 例項。

授權範圍

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

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

詳情請參閱授權指南。

訊息回覆選項

指定訊息的回覆方式。日後可能會新增更多州/省。

列舉
MESSAGE_REPLY_OPTION_UNSPECIFIED 預設。發起對話串。
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD 建立訊息，以回覆 thread ID 或 threadKey 指定的執行緒。如果失敗，訊息會改為發起新的執行緒。
REPLY_MESSAGE_OR_FAIL 建立訊息，以回覆 thread ID 或 threadKey 指定的執行緒。如果失敗，則改為傳回 NOT_FOUND 錯誤。