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

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

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

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

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

• ConfirmAction
• 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.