メールのリアクションを使用すると、ユーザーは絵文字を使って楽しく、スムーズにメール メッセージに返信できます。
形式
メールのリアクションは、リアクションであることを示す特別なパートを含む、通常の 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 で絵文字フィールドがチェックされます。内容は、バージョン 15 以降の Unicode Technical Standard 51 で指定された絵文字のいずれか 1 つと完全に一致している必要があります。これには、肌の色などの参照される拡張機能も含まれます。絵文字の標準が進化するにつれて、Gmail は少なくとも最新バージョン - 1 のサポートを約束します。Gmail は、新しくリリースされた標準を実装するために必要な期間を除き、最新バージョンをサポートしている可能性があります。フィールドが欠落しているか、空であるか、絵文字が 1 つだけ含まれていない場合、Gmail はその部分を無効と見なします。
ディスプレイ
有効なメールのリアクション部分を含むメッセージの場合、Gmail は In-Reply-To ヘッダーで指定されたメッセージの近くの絵文字フィールドに絵文字を表示します。また、その絵文字で受け取ったリアクションの数も含まれる場合があります。リアクションの送信者が表示される場合や、他の UI 処理が行われる場合もあります。In-Reply-To ヘッダーがない場合や、指定された ID のメッセージが会話スレッドで見つからない場合、Gmail はリアクション メッセージを通常のメールとして表示します。ユーザーがメッセージを削除した、スレッドが長すぎるなど、さまざまな理由で Gmail がメッセージを見つけられないことがあります。
無効なメールのリアクション メッセージを表示する際、Gmail は text/html 部分が存在する場合はそれを表示します。それ以外の場合は、text/plain 部分を使用します。いずれかの身体部位が存在しない場合、Gmail には空のメッセージが表示されます。
上限
Gmail では、メールのリアクションのサポートを追加するクライアントに対して、リアクションがユーザーを圧倒しないように制限を追加することを推奨しています。具体的には、次のとおりです。
- メーリング リストからのメッセージではリアクションを許可しないようにします。
- 宛先が多すぎるメッセージでは、リアクションを許可しないでください。（Gmail では、
ToフィールドとCCフィールドの合計で 20 個の異なる受信者の上限が使用されます）。 - 受信者が
ToフィールドまたはCCフィールドにいないメッセージでは、リアクションを許可しないでください。 - すでに多くのリアクションがあるメッセージでは、リアクションを許可しないようにします。（Gmail では、1 つのメッセージに対するユーザーあたりのリアクション数の上限は 20 です）。
これらの上限については、絵文字リアクションでメールに返信するの「絵文字リアクションを送信できない」セクションでも説明しています。