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

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

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

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

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

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

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

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

JSON-LD

<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 إلى رسالة إلكترونية حول عرض ترويجي:

JSON-LD

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