Method: spaces.messages.create

在 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

string

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

格式:spaces/{space}

查詢參數

參數
threadKey
(deprecated)

string

選用設定。已淘汰:請改用 thread.thread_key。執行緒 ID。最多可支援 4000 個半形字元。如要開始或新增至討論串,請建立訊息並指定 threadKeythread.name。如需使用說明,請參閱「發起或回覆訊息串」。

requestId

string

選用設定。這則訊息的專屬要求 ID。指定現有的要求 ID 後,系統將傳回使用該 ID 建立的訊息,而不會建立新訊息。

messageReplyOption

enum (MessageReplyOption)

選用設定。指出訊息是發起討論串,或是回覆討論串。只能在已命名的聊天室中使用。

messageId

string

選用設定。訊息的自訂 ID。讓 Chat 擴充應用程式不必儲存系統指派的 ID,不必在訊息的資源名稱中儲存、更新或刪除訊息 (如訊息 name 欄位中所示)。

這個欄位的值必須符合下列規定:

  • 開頭為 client-。舉例來說,client-custom-name 是有效的自訂 ID,但 custom-name 不是。
  • 長度上限為 63 個半形字元,且只能使用小寫英文字母、數字和連字號。
  • 聊天室中不得重複,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 IDthreadKey
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD 建立訊息做為回覆 thread IDthreadKey 指定的討論串。如果傳送失敗,訊息會改為發起新的討論串。
REPLY_MESSAGE_OR_FAIL 建立訊息做為回覆 thread IDthreadKey 指定的討論串。如果使用新的 threadKey,系統就會建立新的執行緒。如果訊息建立失敗,系統會改為傳回 NOT_FOUND 錯誤。