格式訊息

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

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

設定簡訊格式

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

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

格式	符號	語法範例	Google Chat 中顯示的文字
粗體	*	*你好*	你好
斜體	_ (底線)	_hello_	你好
刪除線	~	~hello~	你好
等寬	` (倒引號)	`hello`	hello
等寬區塊	` ` ` (三個倒引號)	``` Hello World ```	Hello World
項目符號清單	* 或 - (連字號) 後接空格	* 這是清單中的第一個項目 * 這是清單中的第二個項目	這是清單中的第一個項目 這是清單中的第二個項目

例如，請考量下列 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 會將此用做連結文字， 自動將這段文字加上指定網址的超連結。

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

語法範例	Google Chat 中顯示的文字
<https://example.com|Example website>	Example website

管道和連結文字為選用項目，因此 <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} 值的別名。適用對象 舉例來說，如果電子郵件地址是 [e-mail]，您可以指定 使用者的身分為 users/[e-mail]。如要使用電子郵件別名，您的 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 設計及預覽即時通訊應用程式的訊息和使用者介面：

開啟資訊卡建立工具

---

設定段落文字格式

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

格式	範例	轉譯結果
粗體	"This is <b>bold</b>."	這是粗體。
斜體	"This is <i>italics</i>."	這是「斜體」。
底線	"This is <u>underline</u>."	此為底線。
刪除線	"This is <s>strikethrough</s>."	這會是刪除線。
字型顏色	"This is <font color=\"#FF0000\">red font</font>."	這是紅色字型。
超連結	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	這是超連結。
時間	"This is a time format: <time>2023-02-16 15:00</time>."	採用時間格式：2023-02-16 15:00。
換行字元	"This is the first line. <br> This is a new line. 吋	這是第一行。 這是新的路線。

在文字中加入圖示

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

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

使用 Chat 中的圖示

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

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

	空中交易		書店
	獎勵		購物車
	錶面		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		捐款
	電子郵件		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	飯店		HOTEL_ROOM_TYPE
	邀請		MAP_PIN
	會員		MULTIPLE_PEOPLE
	個人		電話號碼
	RESTAURANT_ICON		SHOPPING_CART
	STAR		商店
	票券		訓練
	VIDEO_CAMERA		VIDEO_PLAY

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

使用 Google Material 圖示

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

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

使用自訂圖示

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

以下是自訂圖示的範例：