形式メッセージ

このページでは、Google Chat アプリでのメッセージの送信に使用するテキストの書式について説明します。 次のいずれかを含む:

• 1 人またはすべてのユーザーのハイパーリンクや名前リンクを含むリッチテキスト Chat スペース。
• カード インターフェースに表示されるテキスト。段落テキスト、 ボタンなどのアイコンとともに表示される UI テキスト。

テキスト メッセージの書式を設定する

Chat では、テキスト メッセージに次のような基本的な書式を設定できます。 太字、斜体、取り消し線などの Markdown 構文のサブセットを使用します。マイページ テキスト メッセージとカード メッセージでは、テキストの書式が異なるため、 メッセージは、Chat で使用されているのと同じ構文で できます。

テキスト メッセージの書式を設定するには、次の構文を使用します。

たとえば、次の JSON について考えてみましょう。

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

この書式設定されたテキスト メッセージは、Chat に次の内容を表示します。 スペース:

メール内で送信されたテキストの書式を表示する

ユーザーがメッセージを送信すると、メッセージの書式なしテキストの本文が text フィールド。マークダウンを使用してテキスト メッセージに適用される一部の書式設定 text フィールドにあります。その他の書式設定は、 以下を含む出力専用の formattedText フィールド。

• テキストの追加の Markdown 構文
• ユーザーのメンション
• カスタム ハイパーリンク
• カスタム絵文字

たとえば、ユーザーが送信した次のテキストについて考えてみましょう。

Google Chat の [表示形式] メニューを使用してメッセージを Chat UI で、text フィールドにはテキストのみが表示され、 formattedText フィールドには、マークアップ、テキスト、ハイパーリンクが含まれます。「 次の例は、ハイパーリンクが設定された単語を含むテキスト メッセージの下書きを示しています。 1 つの単語が太字で示されている場合:

メッセージは次の形式で受信されます。

    {
      "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*?",
    }

リンクの書式を設定する

メール本文に通常のリンク URL（ http://www.example.com/。Google Chat ではこれをリンクテキストとして使用し、 そのテキストには、指定された URL に自動的にハイパーリンクが設定されます。

リンクの代替リンクテキストを指定するには、次の構文を使用します。

パイプとリンクのテキストはオプションであるため、<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 アプリが 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 タグのサブセットです。カード メッセージとテキスト メッセージでは、テキストの書式が異なる テキスト メッセージは、テキスト メッセージと同じ構文で Chat ユーザーが使用する

カードビルダーを使用して、Chat 用アプリのメッセージとユーザー インターフェースを設計し、プレビューします。

段落テキストの書式設定

サポートされているタグとその目的は次のとおりです。 table:

テキストにアイコンを追加する

カード内のテキストの横にアイコンを表示するには、 DecoratedText および ButtonList 説明します。

以下のセクションでは、組み込みのアイコン（Google マテリアル）の使用方法について説明します。 装飾されたテキストやボタンで作られたカスタムアイコンです。

Chat のアイコンを使用する

Chat に組み込まれているアイコンを使用するには、 次のいずれかを指定します。

次の表に、カード メッセージで使用できる組み込みアイコンを示します。

「 メールアイコン付きのカードの例を次に示します。

Google マテリアル アイコンを使用する

Google マテリアル アイコンを使用できます 2,500 以上のアイコン オプションから選択して アイコンの太さ、塗りつぶし、評価を調整できます

以下は、Google のマテリアル アイコンを含むカードの例です。

カスタム アイコンを使用する

カスタム アイコンを追加するには、iconUrl フィールドを含め、アイコンの 対応する URL です

カスタム アイコンの例を次に示します。