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
تنسيق الرسالة في "وحدة تحكّم المشرف"
An event happened during mail delivery