واکنش های ایمیلی

واکنش‌های ایمیلی به کاربران اجازه می‌دهد تا با استفاده از ایموجی به پیام‌های ایمیل به شیوه‌ای سرگرم‌کننده و بدون اصطکاک پاسخ دهند.

قالب

واکنش ایمیل یک ایمیل معمولی با فرمت MIME با قسمت خاصی است که نشان دهنده واکنش است.

قالب کلی پیام

رایانامه باید دارای قسمتی از بدنه باشد که دارای Content-Type: text/vnd.google.email-reaction+json باشد که طبق تعریف قالب بندی شده باشد.

یک عضو بدن یکی از این موارد است:

  • بخش سطح بالای پیام. این بدان معنی است که هدر Content-Type ایمیل text/vnd.google.email-reaction+json است.
  • بخشی فرعی از یک بخش MIME چند قسمتی که دارای یک Content-Type of text/vnd.google.email-reaction+json و یک Content-Disposition است که attachment نیست.

ایمیل واکنش همچنین باید دارای بخش‌های text/plain و text/html معمولی باشد تا کلاینت‌های ایمیلی که از واکنش‌های ایمیل پشتیبانی نمی‌کنند، همچنان چیزی را پاسخ دهند. جیمیل توصیه می‌کند قسمت text/vnd.google.email-reaction+json بین قسمت‌های text/plain و text/html قرار دهید. این به این دلیل است که برخی از سرویس گیرندگان ایمیل همیشه آخرین قسمت را بدون توجه به اینکه واقعاً نوع MIME آن را درک می کنند نشان می دهند. به همین ترتیب برخی از سرویس گیرندگان ایمیل فقط قسمت اول را نمایش می دهند.

ایمیل همچنین باید دارای هدر In-Reply-To باشد که حاوی شناسه پیام پیامی است که واکنش به آن اعمال می شود. این باید یک شناسه پیام واحد باشد.

text/vnd.google.email-reaction+json تعریف قسمت

این بخش MIME با فرمت JSON است. دو فیلد دارد:

  • version : یک عدد صحیح نشان دهنده نسخه فرمت واکنش ایمیلی است که این قسمت با آن مطابقت دارد. این باید 1 باشد.
  • emoji : رشته ای که دقیقاً یک نماد ایموجی را نشان می دهد که توسط استاندارد فنی یونیکد 51 تعریف شده است.

اگر 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. جیمیل JSON را تجزیه می کند و اعتبار آن را بررسی می کند. اگر JSON نادرست باشد، Gmail آن قسمت را نامعتبر می‌داند.

  2. جیمیل فیلد نسخه را بررسی می کند. نسخه باید دقیقاً 1 باشد. باید یک عدد صحیح باشد. نمی تواند یک رشته باشد. با پیشرفت فرمت، نسخه های دیگر ممکن است پذیرفته شوند. اگر نسخه ناشناخته یا گم شده باشد، Gmail آن قسمت را نامعتبر می داند.

  3. جیمیل فیلد ایموجی را بررسی می کند. محتویات باید دقیقاً یکی از ایموجی‌های مشخص‌شده در نسخه 15 یا بالاتر استاندارد فنی یونیکد 51 باشد که شامل هر افزونه‌های ارجاعی مانند رنگ پوست می‌شود. همانطور که استاندارد شکلک تکامل می یابد، Gmail متعهد می شود که حداقل آخرین نسخه را پشتیبانی کند - 1. Gmail احتمالاً از آخرین نسخه به جز پنجره مورد نیاز برای اجرای هر استاندارد تازه منتشر شده پشتیبانی می کند. اگر فیلد مفقود، خالی باشد یا دقیقاً حاوی یک ایموجی نباشد، جیمیل آن قسمت را نامعتبر می‌داند.

نمایش

برای پیام‌هایی که بخش‌های واکنش ایمیل معتبری دارند، Gmail شکلک را در فیلد شکلک نزدیک پیام مشخص‌شده توسط هدر In-Reply-To نشان می‌دهد. این همچنین ممکن است شامل تعداد واکنش‌هایی باشد که با آن ایموجی دریافت می‌شود، ممکن است فرستنده آن واکنش و احتمالاً سایر درمان‌های UI را نشان دهد. اگر سرصفحه In-Reply-To وجود نداشته باشد یا پیامی با شناسه داده شده در رشته گفتگو پیدا نشود، Gmail پیام واکنش را به عنوان یک ایمیل معمولی نمایش می دهد. توجه داشته باشید که Gmail ممکن است نتواند پیام را پیدا کند زیرا کاربر آن را حذف کرده است، موضوع خیلی طولانی شده است یا به دلایل دیگر.

هنگام نمایش پیام‌های واکنش ایمیل نامعتبر، Gmail قسمت text/html را در صورت وجود نمایش می‌دهد. در غیر این صورت از قسمت text/plain استفاده می کند. اگر هیچ عضوی از بدن با هیچکدام از آنها وجود نداشته باشد، Gmail یک پیام خالی نمایش می دهد.

محدودیت ها

جیمیل توصیه می‌کند که مشتریانی که به دنبال اضافه کردن پشتیبانی برای واکنش‌های ایمیل هستند، محدودیت‌هایی برای جلوگیری از واکنش‌های شدید کاربران اضافه کنند. به طور خاص:

  • پیام‌های فهرست‌های پستی نباید اجازه واکنش نشان دهند.
  • پیام‌هایی که دریافت‌کنندگان زیادی دارند نباید اجازه واکنش دهند. (Gmail از محدودیت 20 گیرنده مجزا در فیلدهای ترکیبی To و CC استفاده می کند.)
  • پیام‌هایی که گیرنده در قسمت‌های To یا CC نیست نباید اجازه واکنش دهند.
  • پیام‌هایی که قبلاً واکنش‌های زیادی دارند، نباید اجازه واکنش دهند. (Gmail از محدودیت 20 واکنش برای هر کاربر برای هر پیام استفاده می کند.)

این محدودیت‌ها و سایر محدودیت‌ها نیز در بخش «واکنش‌های شکلک ارسال نمی‌شود» در پاسخ به ایمیل‌های دارای واکنش‌های شکلک توضیح داده شده‌اند.

،

واکنش‌های ایمیلی به کاربران اجازه می‌دهد تا با استفاده از ایموجی به پیام‌های ایمیل به شیوه‌ای سرگرم‌کننده و بدون اصطکاک پاسخ دهند.

قالب

واکنش ایمیل یک ایمیل معمولی با فرمت MIME با قسمت خاصی است که نشان دهنده واکنش است.

قالب کلی پیام

رایانامه باید دارای قسمتی از بدنه باشد که دارای Content-Type: text/vnd.google.email-reaction+json باشد که طبق تعریف قالب بندی شده باشد.

یک عضو بدن یکی از این موارد است:

  • بخش سطح بالای پیام. این بدان معنی است که هدر Content-Type ایمیل text/vnd.google.email-reaction+json است.
  • بخشی فرعی از یک بخش MIME چند قسمتی که دارای یک Content-Type of text/vnd.google.email-reaction+json و یک Content-Disposition است که attachment نیست.

ایمیل واکنش همچنین باید دارای بخش‌های text/plain و text/html معمولی باشد تا کلاینت‌های ایمیلی که از واکنش‌های ایمیل پشتیبانی نمی‌کنند، همچنان چیزی را پاسخ دهند. جیمیل توصیه می‌کند قسمت text/vnd.google.email-reaction+json بین قسمت‌های text/plain و text/html قرار دهید. این به این دلیل است که برخی از سرویس گیرندگان ایمیل همیشه آخرین قسمت را بدون توجه به اینکه واقعاً نوع MIME آن را درک می کنند نشان می دهند. به همین ترتیب برخی از سرویس گیرندگان ایمیل فقط قسمت اول را نمایش می دهند.

ایمیل همچنین باید دارای هدر In-Reply-To باشد که حاوی شناسه پیام پیامی است که واکنش به آن اعمال می شود. این باید یک شناسه پیام واحد باشد.

text/vnd.google.email-reaction+json تعریف قسمت

این بخش MIME با فرمت JSON است. دو فیلد دارد:

  • version : یک عدد صحیح نشان دهنده نسخه فرمت واکنش ایمیلی است که این قسمت با آن مطابقت دارد. این باید 1 باشد.
  • emoji : رشته ای که دقیقاً یک نماد ایموجی را نشان می دهد که توسط استاندارد فنی یونیکد 51 تعریف شده است.

اگر 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. جیمیل JSON را تجزیه می کند و اعتبار آن را بررسی می کند. اگر JSON نادرست باشد، Gmail آن قسمت را نامعتبر می‌داند.

  2. جیمیل فیلد نسخه را بررسی می کند. نسخه باید دقیقاً 1 باشد. باید یک عدد صحیح باشد. نمی تواند یک رشته باشد. با پیشرفت فرمت، نسخه های دیگر ممکن است پذیرفته شوند. اگر نسخه ناشناخته یا گم شده باشد، Gmail آن قسمت را نامعتبر می داند.

  3. جیمیل فیلد ایموجی را بررسی می کند. محتویات باید دقیقاً یکی از ایموجی‌های مشخص‌شده در نسخه 15 یا بالاتر استاندارد فنی یونیکد 51 باشد که شامل هر افزونه‌های ارجاعی مانند رنگ پوست می‌شود. همانطور که استاندارد شکلک تکامل می یابد، Gmail متعهد می شود که حداقل آخرین نسخه را پشتیبانی کند - 1. Gmail احتمالاً از آخرین نسخه به جز پنجره مورد نیاز برای اجرای هر استاندارد تازه منتشر شده پشتیبانی می کند. اگر فیلد مفقود، خالی باشد یا دقیقاً حاوی یک ایموجی نباشد، جیمیل آن قسمت را نامعتبر می‌داند.

نمایش

برای پیام‌هایی که بخش‌های واکنش ایمیل معتبری دارند، Gmail شکلک را در فیلد شکلک نزدیک پیام مشخص‌شده توسط هدر In-Reply-To نشان می‌دهد. این همچنین ممکن است شامل تعداد واکنش‌هایی باشد که با آن ایموجی دریافت می‌شود، ممکن است فرستنده آن واکنش و احتمالاً سایر درمان‌های UI را نشان دهد. اگر سرصفحه In-Reply-To وجود نداشته باشد یا پیامی با شناسه داده شده در رشته گفتگو پیدا نشود، Gmail پیام واکنش را به عنوان یک ایمیل معمولی نمایش می دهد. توجه داشته باشید که Gmail ممکن است نتواند پیام را پیدا کند زیرا کاربر آن را حذف کرده است، موضوع خیلی طولانی شده است یا به دلایل دیگر.

هنگام نمایش پیام‌های واکنش ایمیل نامعتبر، Gmail قسمت text/html را در صورت وجود نمایش می‌دهد. در غیر این صورت از قسمت text/plain استفاده می کند. اگر هیچ عضوی از بدن با هیچکدام از آنها وجود نداشته باشد، Gmail یک پیام خالی نمایش می دهد.

محدودیت ها

جیمیل توصیه می‌کند که مشتریانی که به دنبال اضافه کردن پشتیبانی برای واکنش‌های ایمیل هستند، محدودیت‌هایی برای جلوگیری از واکنش‌های شدید کاربران اضافه کنند. به طور خاص:

  • پیام‌های فهرست‌های پستی نباید اجازه واکنش نشان دهند.
  • پیام‌هایی که دریافت‌کنندگان زیادی دارند نباید اجازه واکنش دهند. (Gmail از محدودیت 20 گیرنده مجزا در فیلدهای ترکیبی To و CC استفاده می کند.)
  • پیام‌هایی که گیرنده در قسمت‌های To یا CC نیست نباید اجازه واکنش دهند.
  • پیام‌هایی که قبلاً واکنش‌های زیادی دارند، نباید اجازه واکنش دهند. (Gmail از محدودیت 20 واکنش برای هر کاربر برای هر پیام استفاده می کند.)

این محدودیت‌ها و سایر محدودیت‌ها نیز در بخش «واکنش‌های شکلک ارسال نمی‌شود» در پاسخ به ایمیل‌های دارای واکنش‌های شکلک توضیح داده شده‌اند.