メールのリアクションを使用すると、ユーザーは絵文字を使って楽しく簡単にメール メッセージに返信できます。
形式
メールのリアクションは、リアクションであることを示す特別な部分が含まれる、通常の MIME 形式のメールです。
メッセージの全体的な形式
メールには、定義に記載されている形式の Content-Type:
text/vnd.google.email-reaction+json を含む本文部分が必要です。
身体の部位は次のいずれかです。
- メッセージの最上位部分。つまり、メールの
Content-Typeヘッダーはtext/vnd.google.email-reaction+jsonです。 Content-Typeがtext/vnd.google.email-reaction+jsonで、Content-Dispositionがattachmentではないマルチパート MIME パートのサブパート。
リアクション メールには、メールのリアクションをサポートしていないメール クライアントでも返信として何かが表示されるように、通常の text/plain と text/html の部分も含める必要があります。Gmail では、text/vnd.google.email-reaction+json 部分を text/plain 部分と text/html 部分の間に配置することをおすすめします。これは、一部のメール クライアントが、MIME タイプを実際に認識しているかどうかにかかわらず、常に最後の部分を表示するためです。同様に、一部のメール クライアントでは最初の部分のみが表示されます。
また、メールには、リアクションが適用されるメッセージのメッセージ ID を含む In-Reply-To ヘッダーも含まれている必要があります。これは単一のメッセージ ID にする必要があります。
text/vnd.google.email-reaction+json 部品定義
この MIME 部分は JSON 形式です。次の 2 つのフィールドがあります。
version: この部分が準拠するメール リアクション形式のバージョンを表す整数。これは1にする必要があります。emoji: Unicode Technical Standard 51 で定義されている 1 つの絵文字記号を正確に表す文字列。
Content-Transfer-Encoding がバイナリ形式の場合は、JSON で UTF-8 文字エンコードを使用する必要があります。それ以外の場合、Content-Transfer-Encoding は任意の標準エンコードにできます。
Gmail による text/vnd.google.email-reaction+json の解釈
Gmail は、リアクションのように見えるメールを受信すると、リアクション部分を検証し、そのメールに特別な表示処理を適用します。
検証
Gmail は、受信した text/vnd.google.email-reaction+json 部分を含むすべてのメールを検証します。部分が不正な形式の場合、その部分は無効と見なされ、メッセージはリアクションとして扱われません。
具体的には、次のとおりです。
Gmail は JSON を解析して有効性を確認します。JSON の形式が正しくない場合、Gmail はその部分を無効と見なします。
Gmail はバージョン フィールドを確認します。バージョンは 1 にする必要があります。整数である必要があります。文字列は使用できません。形式が進化するにつれて、他のバージョンが承認される可能性があります。バージョンが不明またはない場合、Gmail はその部分を無効と見なします。
Gmail は絵文字フィールドを確認します。内容は、Unicode 技術標準 51 のバージョン 15 以降で指定されている絵文字のいずれか（肌の色など、参照される拡張機能を含む）にする必要があります。絵文字の標準が進化するにつれて、Gmail は少なくとも最新バージョン 1 をサポートすることを約束します。Gmail は、新しくリリースされた標準を実装するために必要な期間を除き、最新バージョンをサポートしている可能性があります。フィールドが欠落している、空である、または 1 つの絵文字が正確に含まれていない場合、その部分は無効と見なされます。
ディスプレイ
有効なメール リアクション パートを含むメールの場合、Gmail は In-Reply-To ヘッダーで指定されたメッセージの近くの絵文字フィールドに絵文字を表示します。また、その絵文字で受け取ったリアクションの数や、そのリアクションの送信者、その他の UI 処理も含まれる場合があります。In-Reply-To ヘッダーがない場合や、指定された ID のメールが見つからない場合は、Gmail はリアクション メールを通常のメールとして表示します。ユーザーがメールを削除した、スレッドが長すぎる、その他の理由により、Gmail でメールが見つからない場合があります。
無効なメールのリアクション メッセージを表示する場合、Gmail は text/html 部分（存在する場合）を表示します。それ以外の場合は、text/plain 部分が使用されます。どちらの体部位も存在しない場合は、空のメッセージが表示されます。
上限
メールのリアクションのサポートを追加するクライアントは、リアクションがユーザーに圧倒されないように、制限を追加することをおすすめします。具体的には、次のとおりです。
- メーリング リストからのメッセージにはリアクションを許可しない。
- 受信者が多いメッセージでは、リアクションを許可しないでください。（Gmail では、
ToフィールドとCCフィールドを組み合わせて、20 個の個別の受信者を指定できます）。 - 受信者が
ToフィールドまたはCCフィールドにない場合、メッセージでリアクションを許可しないでください。 - すでに多くのリアクションが付いているメッセージには、リアクションを許可しないでください。（Gmail では、1 つのメッセージに対してユーザーあたり 20 件のリアクションという制限があります）。
これらの上限とその他の上限については、絵文字のリアクションを使用してメールに返信するの「絵文字のリアクションを送信できない」セクションでも説明しています。