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 擴充應用程式以使用者的身分進行驗證，輸出內容會填入「使用者」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)

選用設定。資訊卡的陣列。

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

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

使用 Card Builder 設計及預覽資訊卡。

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)

選用設定。顯示在訊息底部的一或多個互動小工具。您可以將配件小工具新增至含有文字、卡片或兩者皆有的訊息中。不支援含有對話方塊的訊息。詳情請參閱「在訊息底部新增互動式小工具」。

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