格式訊息

本頁面說明 Google Chat 應用程式如何為文字設定格式，以傳送含有下列任一內容的訊息：

• 含有超連結或在 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 的「Format」選單格式化，則 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 聊天室中 @提及一個或所有使用者。即時通訊應用程式無法在處於匯入模式的聊天室中提及使用者，也不得提及任何未加入聊天室的使用者。

使用 @ 號提及特定使用者

如要使用 @號提及特定使用者，請在簡訊中加入 <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 互動事件的 message.sender.name 欄位。

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

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

• 如果您使用 People API，也可以透過 people.get 方法識別使用者 ID。

使用 @ 號提及所有使用者

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

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

設定資訊卡中的文字格式

在資訊卡中，大部分的文字欄位都支援使用少量 HTML 標記組合的基本文字格式。您在資訊卡訊息中設定的文字格式與文字訊息不同，因為文字訊息的格式設定與 Chat 使用者使用的語法相同。

使用資訊卡建構工具設計及預覽 Chat 應用程式的訊息和使用者介面：

設定段落文字格式

下表顯示支援的標記及其用途：

在文字中加入圖示

如要在資訊卡中的文字旁顯示圖示，您可以使用 DecoratedText 和 ButtonList 小工具。

以下各節將說明如何在修飾文字或按鈕中使用內建圖示、Google Material 圖示或自訂圖示。

使用 Chat 中的圖示

如要使用 Chat 提供的內建圖示，請指定下列其中一項：

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

以下是含有電子郵件圖示的資訊卡範例：

使用 Google Material 圖示

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

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

使用自訂圖示

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

以下是自訂圖示的範例：