形式メッセージ

テキスト メッセージでカスタム絵文字を使用する

チャットアプリは、カスタム絵文字を含むテキスト メッセージを送信して、メッセージをカスタマイズできます。カスタム絵文字は Google Workspace 組織でのみ使用できます。管理者は組織でカスタム絵文字を有効にする必要があります。詳しくは、Google Chat のカスタム絵文字についてとカスタム絵文字の権限を管理するをご覧ください。

カスタム絵文字を含むメッセージを作成するには、アプリでユーザー認証を使用する必要があります。カスタム絵文字は、Webhook として作成されたメッセージや、アプリ認証で作成されたメッセージではサポートされていません。

メッセージのテキストにカスタム絵文字を追加するには、customEmoji リソースの name または emoji_name を指定します。

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

このサンプルを使用するには、CUSTOM_EMOJI_ID をカスタム絵文字の ID に置き換えます。この ID は、customEmoji リソースの name フィールドまたは emoji_name フィールドで確認できます。

テキスト メッセージでユーザーの名前リンクを使用する

Chat 用アプリは、Chat スペース内の 1 人またはすべてのユーザーを @メンションするテキスト メッセージを送信できます。スペースに参加していないユーザーや、インポート モードのスペースに言及するには、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 用アプリのメッセージとユーザー インターフェースを設計してプレビューします。

段落テキストの書式を設定する

サポートされているタグとその目的を次の表に示します。

また、マークダウン構文と次のタグも使用できます。

This is a code block.

テキスト段落のコンテンツの書式設定時に使用する構文を選択するには、[テキスト構文] フィールドを使用します。

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

カード内のテキストの横にアイコンを表示するには、DecoratedText ウィジェットと ButtonList ウィジェットを使用します。

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

Chat のアイコンを使用する

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

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

以下に、メールアイコンを含むカードの例を示します。

Google Material アイコンを使用する

Google マテリアル アイコンを使用すると、2,500 以上のアイコン オプションから選択し、アイコンの太さ、塗りつぶし、グレードをカスタマイズできます。

Google マテリアル アイコンを含むカードの例を次に示します。

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

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

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