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

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

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

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

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

• ConfirmAction
• SaveAction

ملاحظة: قبل البدء، تأكَّد من فهم كيفية تضمين المخططات في الرسائل الإلكترونية ومن الإلمام بـ اختبار المخططات.

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

يمكنك إضافة زر تأكيد بنقرة واحدة إلى الرسائل الإلكترونية التي تطلب من المستخدمين الموافقة على أمر ما وتأكيده والإقرار به. بعد أن ينقر المستخدم على الزر، سترسل Google طلب http إلى خدمتك، ما يؤدي إلى تسجيل التأكيد. لا يمكن التفاعل مع 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.

ملاحظة: لا تزال بعض المخططات التي تستخدمها Google تخضع لعملية التوحيد في schema.org، لذا قد تتغيّر في المستقبل. مزيد من المعلومات.