REST Resource: spaces.messages

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。詳情請參閱「命名訊息」。

object (User)

僅供輸出。建立訊息的使用者。如果 Chat 應用程式以使用者身分進行驗證，輸出內容就會填入 user name 和 type。

string (Timestamp format)

選用設定。不可變動。如果是在 Chat 中建立的聊天室，則為訊息建立時間。這個欄位只會輸出，除非用於匯入模式聊天室。

對於匯入模式空間，請將這個欄位設為訊息在來源中建立的歷史時間戳記，以便保留原始建立時間。

string (Timestamp format)

僅供輸出。使用者上次編輯訊息的時間。如果訊息從未經過編輯，這個欄位會留空。

string (Timestamp format)

僅供輸出。訊息在 Google Chat 中遭到刪除的時間。如果訊息從未刪除，這個欄位會留空。

string

選用設定。訊息的純文字內文。第一個圖片、影片或網頁連結會產生預覽方塊。你也可以@提及 Google Chat 使用者，或是提及聊天室中的所有人。

如要瞭解如何建立文字訊息，請參閱「傳送訊息」。

string

僅供輸出。包含訊息 text，並加入標記來說明格式。這個欄位可能無法擷取 UI 中顯示的所有格式，但會包含下列格式：

• 標記語法：適用於粗體、斜體、刪除線、固定寬度、固定寬度區塊和項目符號清單。

• 使用者提及：使用格式 <users/{user}>。

• 使用 <{url}|{rendered_text}> 格式的自訂超連結，其中第一個字串是網址，第二個字串是算繪文字，例如 <http://example.com|custom text>。

• 使用 :{emojiName}: 格式的自訂表情符號，例如 :smile:。這項功能不適用於萬國碼表情符號，例如 U+1F600 代表笑臉表情符號。

詳情請參閱「查看訊息中傳送的文字格式」

object (Card)

已淘汰：請改用 cardsV2。

您可以使用富格式和互動式資訊卡來顯示 UI 元素，例如格式文字、按鈕和可點選圖片。資訊卡通常會顯示在訊息的純文字內文下方。cards 和 cardsV2 的大小上限為 32 KB。

object (CardWithId)

選用設定。cards 陣列。

只有 Chat 應用程式可以建立資訊卡。如果即時通訊應用程式以使用者身分進行驗證，訊息就無法包含資訊卡。

如要瞭解如何建立含有資訊卡的訊息，請參閱「傳送訊息」。

使用資訊卡建構工具設計及預覽資訊卡。

object (Annotation)

僅供輸出。與這則訊息中 text 相關的註解。

object (Thread)

郵件所屬的討論串。如需使用範例，請參閱「發起或回覆訊息討論串」。

object (Space)

僅供輸出。如果 Chat 應用程式以使用者身分進行驗證，輸出內容只會填入 聊天室 name。

string

選用設定。訊息資訊卡的純文字說明，用於實際資訊卡無法顯示時 (例如行動通知)。

object (ActionResponse)

僅限輸入。Chat 應用程式可用來設定回應發布方式的參數。

string

僅供輸出。訊息的純文字內文，已移除所有 Chat 應用程式提及內容。

object (SlashCommand)

僅供輸出。斜線指令資訊 (如適用)。

object (Attachment)

選用設定。使用者上傳的附件。

object (MatchedUrl)

僅供輸出。spaces.messages.text 中的網址，符合連結預覽模式。詳情請參閱「預覽連結」。

boolean

僅供輸出。如果是 true，則表示該訊息是回覆串中的回覆。當 false 時，訊息會顯示在聊天室的頂層對話中，可能是討論串的第一則訊息，也可能是沒有討論串回覆的訊息。

如果聊天室不支援在討論串中回覆，這個欄位一律會顯示 false。

string

選用設定。訊息的自訂 ID。您可以使用欄位來識別訊息，或取得、刪除或更新訊息。如要設定自訂 ID，請在建立訊息時指定 messageId 欄位。詳情請參閱「命名訊息」。

object (EmojiReactionSummary)

僅供輸出。訊息中的表情符號回應摘要清單。

object (User)

選用設定。不可變動。建立訊息的輸入內容，否則只會輸出。可查看訊息的使用者。設定後，訊息就會設為私密，只有指定使用者和 Chat 應用程式可看見。如要在要求中加入這個欄位，您必須使用應用程式驗證呼叫 Chat API，並省略下列項目：

• 附件
• 配件小工具

詳情請參閱「私下傳送訊息」。

object (DeletionMetadata)

僅供輸出。已刪除訊息的相關資訊。設定 deleteTime 時，系統會刪除訊息。

object (QuotedMessageMetadata)

僅供輸出。Google Chat 使用者在聊天室中引用的訊息相關資訊。Google Chat 使用者可以引用訊息來回覆。

object (AttachedGif)

僅供輸出。郵件中附加的 GIF 圖片。

object (AccessoryWidget)

選用設定。一或多個互動小工具，會顯示在訊息底部。您可以在含有文字、資訊卡或文字和資訊卡的訊息中加入附屬小工具。不支援含有對話方塊的訊息。詳情請參閱「在訊息底部新增互動式小工具」。

如要建立含有配件小工具的訊息，您必須驗證應用程式。