このページでは、Google Chat アプリでのメッセージの送信に使用するテキストの書式について説明します。 次のいずれかを含む:
- 1 人またはすべてのユーザーのハイパーリンクや名前リンクを含むリッチテキスト Chat スペース。
- カード インターフェースに表示されるテキスト。段落テキスト、 ボタンなどのアイコンとともに表示される UI テキスト。
テキスト メッセージの書式を設定する
Chat では、テキスト メッセージに次のような基本的な書式を設定できます。 太字、斜体、取り消し線などの Markdown 構文のサブセットを使用します。マイページ テキスト メッセージとカード メッセージでは、テキストの書式が異なるため、 メッセージは、Chat で使用されているのと同じ構文で できます。
テキスト メッセージの書式を設定するには、次の構文を使用します。
| 形式 | 記号 | 構文の例 | Google Chat に表示されるテキスト |
|---|---|---|---|
| 太字 | * | *こんにちは* | こんにちは |
| 斜体 | _（アンダースコア） | _hello_ | こんにちは |
| 取り消し線 | ~ | こんにちは～ | |
| 等幅 | `（バッククォート） | `hello` | hello |
| 等幅ブロック | ` ` `（3 つのバッククォート） | ``` Hello World ``` |
Hello |
| 箇条書き | * または -（ハイフン）、その後にスペース | * これはリスト内の最初の項目です * これはリストの 2 番目の項目です |
|
たとえば、次の 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 に自動的にハイパーリンクが設定されます。
リンクの代替リンクテキストを指定するには、次の構文を使用します。
| 構文の例 | Google Chat に表示されるテキスト |
|---|---|
<https://example.com|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 アプリが Google Chat によって送信されたメッセージに
message.sender.nameフィールドを使用できます。MESSAGEインタラクション イベント。 Google Chat アプリが 非同期テキスト メッセージ
users/{user}の値は、次の方法で指定できます。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:
| 形式 | 例 | レンダリングされた結果 |
|---|---|---|
| 太字 | "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>." |
これは赤色のフォントです。 |
| Hyperlink | "This is a <a href=\"https://www.google.com\">hyperlink</a>." |
これはハイパーリンクです。 |
| 時間 | "This is a time format: <time>2023-02-16 15:00</time>." |
時刻の形式は です。 |
| 改行 | "This is the first line. <br> This is a new line. インチ |
これが 1 行目です。 これは新しい行です。 |
テキストにアイコンを追加する
カード内のテキストの横にアイコンを表示するには、
DecoratedText
および
ButtonList
説明します。
以下のセクションでは、組み込みのアイコン（Google マテリアル）の使用方法について説明します。 装飾されたテキストやボタンで作られたカスタムアイコンです。
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 マテリアル アイコンを使用する
Google マテリアル アイコンを使用できます 2,500 以上のアイコン オプションから選択して アイコンの太さ、塗りつぶし、評価を調整できます
以下は、Google のマテリアル アイコンを含むカードの例です。
カスタム アイコンを使用する
カスタム アイコンを追加するには、iconUrl フィールドを含め、アイコンの
対応する URL です
カスタム アイコンの例を次に示します。