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

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