إجراءات بنقرة واحدة

تسمح إجراءات النقرة الواحدة للمستخدمين بتنفيذ العمليات من البريد الوارد مباشرةً بدون الحاجة إلى مغادرة Gmail. يتم تنفيذ الإجراءات بنقرة واحدة من خلال الإعلان عن HttpActionHandler مع عنوان URL للخدمة. لمزيد من التفاصيل، يُرجى الرجوع إلى مقالة طلبات معالجة البيانات.

إجراءات بنقرة واحدة في Gmail:

حالات الاستخدام

إجراءات "نقرة واحدة" المتاحة حاليًا في Gmail هي:

• تأكيد الإجراء
• SaveAction (حفظ الإجراء)

تأكيد الإجراء

يمكنك إضافة زر التأكيد بنقرة واحدة إلى الرسائل الإلكترونية التي تتطلّب من المستخدمين الموافقة على المحتوى وتأكيده والإقرار به. بمجرد أن ينقر المستخدم على الزر، سيتم إصدار طلب http من Google إلى خدمتك، مع تسجيل عملية التأكيد. لا يمكن التفاعل مع ConfirmAction إلا مرة واحدة.

يضيف البيان التالي زرّ ConfirmAction إلى رسالة إلكترونية حول تقرير النفقات:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Approve Expense",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://myexpenses.com/approve?expenseId=abc123"
    }
  },
  "description": "Approval request for John's $10.13 expense for office supplies"
}
</script>

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Approve Expense"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
    </div>
  </div>
  <meta itemprop="description" content="Approval request for John's $10.13 expense for office supplies"/>
</div>

حفظ الإجراء

يمكن استخدام SaveAction لوصف التفاعلات، مثل حفظ قسيمة أو إضافة أغانٍ إلى قائمة انتظار الاستماع. لا يمكن التفاعل مع SaveAction إلا مرة واحدة.

يضيف البيان التالي زر SaveAction إلى رسالة إلكترونية حول أحد العروض:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "SaveAction",
    "name": "Save Offer",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://offers-everywhere.com/save?offerId=xyz789"
    }
  },
  "description": "$5 meal at Joe's Diner"
}
</script>

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/SaveAction">
    <meta itemprop="name" content="Save Offer"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://offers-everywhere.com/save?offerId=xyz789"/>
    </div>
  </div>
  <meta itemprop="description" content="$5 meal at Joe's Diner"/>
</div>

اختبار الترميز

يمكنك التحقق من صحة الترميز باستخدام أداة اختبار ترميز البريد الإلكتروني. الصق رمز الترميز وانقر على الزر التحقق من الصحة لفحص المحتوى والحصول على تقرير حول أي أخطاء حدثت.

المواصفات

بالنسبة إلى الخصائص المتاحة لهذه الإجراءات، يمكنك الرجوع إلى المستندات للأنواع المحددة من ConfirmAction وSaveAction.