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

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

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

في ما يلي الإجراءات بنقرة واحدة المتاحة في 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، لذا قد تتغيّر في المستقبل. مزيد من المعلومات.