تتيح الإجراءات بنقرة واحدة للمستخدمين إجراء العمليات مباشرةً من البريد الوارد بدون الحاجة إلى مغادرة Gmail. يتم تنفيذ الإجراءات بنقرة واحدة من خلال تقديم بيان عن HttpActionHandler
مع عنوان URL لخدمتك. لمزيد من التفاصيل، يُرجى الاطّلاع على معالجة طلبات الإجراءات.
الإجراءات بنقرة واحدة في 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.