格式訊息

本頁面說明 Google Chat 應用程式如何設定文字格式，以便傳送訊息。 包含下列任何項目：

• 這個 RTF 格式內含超連結或 @號提及他人， Chat 聊天室。
• 資訊卡介面中顯示的文字，包括段落文字或 顯示在圖示 (例如按鈕) 旁的 UI 文字。

設定簡訊格式

Chat 支援在簡訊中加入基本格式設定，包括 粗體、斜體和刪除線，方法是使用一小部分的 Markdown 語法。個人中心 簡訊和資訊卡訊息的文字格式不同 訊息的語法與 Chat 的語法相同 使用。

如要設定簡訊格式，請使用下列語法：

例如，請考量下列 JSON：

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

這段格式化簡訊會在 Chat 中顯示以下內容 聊天室：

查看郵件中傳送的文字格式

使用者傳送訊息時，訊息的純文字內文會 「text」欄位。透過 Markdown 為簡訊套用的部分格式 語法就在 text 欄位中。其他格式設定包含 僅限輸出的 formattedText 欄位，包括：

• 文字適用的其他 Markdown 語法
• 使用者提及的內容
• 自訂超連結
• 自訂表情符號

以使用者傳送的文字為例：

如果郵件已經套用格式，請使用「 Chat UI，text 欄位只有文字，而 formattedText 欄位包含標記、文字和超連結。 以下範例顯示包含超連結文字的簡訊草稿 清單中的項目，而一個粗體字：

訊息會以下列格式接收：

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

設定連結格式

如果您在訊息文字中加入純文字連結網址，例如 http://www.example.com/，Google Chat 會將此用做連結文字， 自動將這段文字加上指定網址的超連結。

如要為連結提供替代連結文字，請使用以下語法：

管道和連結文字為選用項目，因此 <https://www.example.com/> 和 https://www.example.com/ 等於。

在簡訊中提及使用者

即時通訊應用程式可以 傳送簡訊 使用 @ 號在 Chat 聊天室中使用 @ 號提及一或多位使用者。 Chat 擴充應用程式無法提及 處於匯入模式的聊天室，或是 尚未加入聊天室。

使用 @ 號提及特定使用者

如要使用 @號提及特定使用者，請在以下位置的簡訊中加入 <users/{user}>： {user} 是使用者 ID。以下方文字為例 在訊息中，123456789012345678901 代表使用者 Mahan S 的 ID。

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

簡訊會顯示如下：

您可以透過下列方式指定 users/{user} 值：

• 如果 Google Chat 應用程式正在回應 可以在 message.sender.name 欄位使用 MESSAGE 個互動事件。

• 如果您的 Google Chat 應用程式正在建立 非同步簡訊 您可以用下列方式指定 users/{user} 的值：

  • 使用 Google Chat 的「name」欄位 User 資源，例如 users/123456789012345678901。
  • 將使用者的電子郵件地址做為 {user} 值的別名。適用對象 舉例來說，如果電子郵件地址是 mahan@example.com，您可以指定 使用者的身分為 users/mahan@example.com。如要使用電子郵件別名，您的 Google Chat 應用程式必須 以使用者的身分進行驗證。

• 如果使用 People API，您還可以使用 people.get 方法 找出 User-ID

使用 @ 號提及所有使用者

如要建立簡訊，並在聊天室中使用 @號提及所有人，請將 {user} 替換成 all。以下 JSON 範例在訊息中提及所有使用者：

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

設定資訊卡中的文字格式

在資訊卡中，大部分的文字欄位都支援使用 HTML 標記子集資訊卡訊息的文字格式與文字格式不同 因為文字訊息的語法與 即時通訊使用者所使用的語言。

使用 Card Builder 設計及預覽即時通訊應用程式的訊息和使用者介面：

設定段落文字格式

以下為支援的標記及其用途： 資料表：

在文字中加入圖示

如要在資訊卡中的文字旁顯示圖示，可以使用 DecoratedText敬上 和 ButtonList

以下各節說明如何使用內建圖示 (Google Material) 圖示、自訂圖示和自訂圖示。

使用 Chat 中的圖示

如要使用 Chat 內建的圖示，請按照下列步驟操作： 請指定下列其中一項：

下表列出適用於資訊卡訊息的內建圖示：

以下是包含電子郵件圖示的卡片範例：

使用 Google Material 圖示

您可以使用 Google Material 圖示 超過 2500 個圖示選項供您選擇，並且自訂 圖示的粗細、填滿和等級

以下是包含 Google Material 圖示的資訊卡範例：

使用自訂圖示

如要新增自訂圖示，請加入 iconUrl 欄位並指定圖示的 對應的網址

以下是自訂圖示的範例：