Gmail Activity Events
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد هذا المستند الأحداث والمَعلمات لأنواع مختلفة من أحداث النشاط في Gmail. يمكنك استرداد هذه الأحداث من خلال
استدعاء Activities.list()
مع applicationName=gmail.
نوع حدث التدقيق في Gmail
نوع أحداث التدقيق في Gmail التي يتم تصديرها إلى عملاء Google Workspace.
يتم عرض الأحداث من هذا النوع مع type=delivery_type.
حدث التدقيق في Gmail
.
تفاصيل الحدث
اسم الحدث
delivery
المَعلمات
event_info
message
معلومات عامة عن الحدث يمكن استخدام المَعلمة المتداخلة المُدرَجة كفلتر باستخدام اسم المَعلمة الكامل.
event_info.mail_event_type (عدد صحيح)
نوع الحدث المُسجَّل بما أنّ eventName هو دائمًا قيمة ثابتة (delivery) لسجلاتّ التدقيق في Gmail، يساعد هذا الحقل في تحديد الحدث الفعلي الذي وقع.
القيم المحتمَلة هي:
0: نوع حدث بريد غير معروف لا تظهر هذه المرحلة أثناء تسليم البريد في "أداة التحقيق الأمني". لمعرفة التفاصيل، انتقِل إلى message_info.action_type.
1: تم إرسال الرسالة
2: تم استلام الرسالة
3: طبَّق مستخدم Gmail تصنيف الرسائل غير المرغوب فيها يدويًا على الرسالة. على سبيل المثال، وضع المستخدم علامة على الرسالة كرسالة غير مرغوب فيها أو كتصيّد احتيالي أو رسالة غير مرغوب فيها.
4: وضع Gmail علامة على الرسالة كرسالة غير مرغوب فيها بعد التسليم. يمكن أن تتسبب عدة عوامل في ذلك، بما في ذلك سوء السمعة للمرسل أو تجزئات الفيروسات الجديدة.
5: تم عزل الرسالة
6: تم إصدار الرسالة من وحدة العزل
7: تم فتح الرسالة للمرة الأولى
8: تم وضع علامة على الرسالة كرسالة غير مقروءة
9: تم الردّ على الرسالة للمرة الأولى
10: تم إعادة توجيه الرسالة للمرة الأولى
11: تمت إعادة توجيه الرسالة تلقائيًا باستخدام إعداد إعادة التوجيه في حساب Gmail
12: تم نقل الرسالة إلى "البريد الوارد"
13: تم نقل الرسالة إلى "المهملات"
14: تمت إزالة الرسالة من "المهملات"
15: تم النقر على رابط في نص الرسالة
16: تم النقر على رابط في مرفق الرسالة أثناء معاينة المرفق
17: تم تنزيل واحد أو أكثر من مرفقات الرسائل
18: تم حفظ واحد أو أكثر من مرفقات الرسائل في Google Drive
19: تم حفظ عنصر أو أكثر من عناصر Google Drive المضمنة في الرسالة في Google Drive الخاص بالمستلم
20: تم تطبيق تصنيف على الرسالة
21: تم تغيير تصنيف الرسالة
22: تم إزالة تصنيف من الرسالة
23: تم تطبيق تصنيف على جميع مرفقات الرسائل
24: تم تغيير تصنيف جميع مرفقات الرسائل
25: تم إزالة تصنيف من جميع مرفقات الرسائل
26: تم أرشفة الرسالة
27: تم حذف الرسالة نهائيًا
28: تمت معاينة واحد أو أكثر من مرفقات الرسائل
29: تم حفظ الرسالة كمسودة
30: تعذّر تسليم الرسالة وتم ارتدادها
31: تم عرض الرسالة، بما في ذلك القراءات الأولى واللاحقة. للحصول على تفاصيل حول مشكلة معروفة في نظام iOS، يُرجى الانتقال إلى مقالة المشاكل المعروفة في Google Workspace.
32: تم تنزيل الرسالة
33: وصل أحد التطبيقات إلى رسالة نيابةً عن مستخدم
34: تم فرض حدّ على معدّل الاستلام: تم رفض الرسالة أو تم تقليل معدّل استلامها بسبب حدود معدّل الاستلام (رفض الخدمة)
35: بدأ المستخدم أو واجهة برمجة التطبيقات عملية إرسال الرسالة الإلكترونية
.
عيّنة طلب
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/gmail?eventName=delivery&maxResults=10&access_token=YOUR_ACCESS_TOKEN
تاريخ التعديل الأخير: 2026-09-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-09-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]