在 Google Chat 聊天室中建立訊息。如需範例,請參閱「傳送訊息」。
create()
方法需要使用者或應用程式驗證。Chat 會根據您在要求中使用的驗證類型,決定訊息傳送者的方式。
下圖顯示您使用應用程式驗證功能時,Chat 如何歸因訊息。Chat 會將 Chat 應用程式顯示為訊息傳送者。訊息內容可包含文字 (text
)、資訊卡 (cardsV2
) 和配件小工具 (accessoryWidgets
)。
下圖顯示當您使用使用者驗證功能時,Chat 如何歸因訊息。Chat 會將使用者顯示為訊息傳送者,並顯示即時通訊應用程式的名稱,藉此將 Chat 應用程式歸因於訊息。訊息內容只能包含文字 (text
)。
訊息內容的大小上限為 32,000 個位元組 (含訊息內容)。
HTTP 要求
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
必要欄位。要建立訊息的聊天室資源名稱。 格式: |
查詢參數
參數 | |
---|---|
threadKey |
選用設定。已淘汰:請改用 |
requestId |
選用設定。這則訊息的專屬要求 ID。指定現有的要求 ID 後,系統將傳回使用該 ID 建立的訊息,而不會建立新訊息。 |
messageReplyOption |
選用設定。指出訊息是發起討論串,或是回覆討論串。只能在已命名的聊天室中使用。 |
messageId |
選用設定。訊息的自訂 ID。讓 Chat 擴充應用程式不必儲存系統指派的 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
https://www.googleapis.com/auth/chat.messages.create
詳情請參閱授權指南。
MessageReplyOption
指定回覆訊息的方式。日後可能會新增更多州/省。
列舉 | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
預設。發起新的討論串。使用這個選項後,系統會忽略所有包含的 thread ID 或 。 |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
建立訊息做為回覆 thread ID 或 指定的討論串。如果傳送失敗,訊息會改為發起新的討論串。 |
REPLY_MESSAGE_OR_FAIL |
建立訊息做為回覆 thread ID 或 指定的討論串。如果使用新的 threadKey ,系統就會建立新的執行緒。如果訊息建立失敗,系統會改為傳回 NOT_FOUND 錯誤。 |