メールのリアクション

メールのリアクションを使用すると、ユーザーは絵文字を使ってメール メッセージに楽しく簡単に返信できます。

形式

メールのリアクションは、リアクションであることを示す特別なパートを含む、通常の 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 部分を含むすべてのメッセージを検証します。パートが不正な形式の場合、無効と見なされ、メッセージはリアクションとして扱われません。

具体的には、次のとおりです。

  1. Gmail は JSON を解析し、その有効性を確認します。JSON の形式が正しくない場合、Gmail はその部分を無効と見なします。

  2. Gmail では、version フィールドがチェックされます。バージョンは 1 である必要があります。整数にする必要があります。文字列は使用できません。形式の進化に伴い、他のバージョンが受け入れられるようになる可能性があります。バージョンが不明または欠落している場合、Gmail はその部分を無効とみなします。

  3. Gmail では、emoji フィールドがチェックされます。コンテンツは、Unicode Technical Standard 51 のバージョン 15 以降で指定された絵文字のいずれか 1 つでなければなりません。これには、肌の色などの参照される拡張機能も含まれます。絵文字の標準が進化するにつれて、Gmail は少なくとも最新バージョンから

    1. Gmail は、新しくリリースされた標準を実装するために必要な期間を除き、最新バージョンをサポートしている可能性があります。フィールドが欠落しているか、空であるか、絵文字が 1 つだけ含まれていない場合、Gmail はその部分を無効と見なします。

ディスプレイ

有効なメールのリアクション部分を含むメールの場合、Gmail は In-Reply-To ヘッダーで指定されたメールの近くの emoji フィールドに絵文字を表示します。また、その絵文字で受け取ったリアクションの数も含まれる場合があります。リアクションの送信者やその他の UI 処理が表示されることもあります。In-Reply-To ヘッダーがない場合や、指定された ID のメッセージが会話スレッドで見つからない場合、Gmail はリアクション メッセージを通常のメールとして表示します。ユーザーがメールを削除した場合や、スレッドが長すぎる場合など、Gmail でメールが見つからないことがあります。

無効なメールのリアクション メッセージを表示するとき、Gmail は text/html 部分が存在する場合はそれを表示します。それ以外の場合は、text/plain 部分を使用します。どちらの本文部分も存在しない場合、Gmail には空のメッセージが表示されます。

上限

Gmail では、メールのリアクションをサポートするクライアントに対して、リアクションがユーザーに過剰に表示されないように制限を適用することを推奨しています。具体的には、次のとおりです。

  • メーリング リストからのメッセージはリアクションをサポートしないようにする必要があります。
  • 宛先が多すぎるメッセージは、リアクションをサポートすべきではありません（To フィールドと CC フィールドの合計で 20 件を超える個別の宛先がある場合など）。
  • 受信者が To フィールドまたは CC フィールドにないメッセージは、リアクションをサポートすべきではありません。
  • すでに多くのリアクションがあるメッセージは、リアクションをサポートすべきではありません（1 つのメッセージに対してユーザーごとに 20 個を超えるリアクションなど）。

これらの上限については、絵文字のリアクションでメールに返信するの「絵文字のリアクションを送信できない」セクションにも記載されています。