واجهة برمجة التطبيقات لإعداد التقارير: تقرير نشاط تدقيق الجهاز

يعرض تقرير نشاط تدقيق الجهاز معلومات عن الأنشطة التي نفذها جميع الأجهزة ضمن إدارة نقاط النهاية من Google. يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع مَعلمات مثل عنوان البريد الإلكتروني للمستخدِم. الحد الأقصى للفترة الزمنية لكل تقرير آخر 180 يومًا.

لا يجوز استخدام تقرير نشاط تدقيق الجهاز إلا للأغراض القانونية فقط في بما يتوافق مع اتفاقية العملاء. عرض المقارنة بين إصدارات Google Workspace لمعرفة الإصدارات التي تتضمن هذه التقارير.

استرداد أحداث تدقيق الجهاز لأحد النطاقات

لاسترداد جميع أحداث تدقيق الجهاز لجميع المستخدمين ضمن نطاقك، استخدم اتباع طلب HTTP GET وتضمين الرمز المميز للتفويض الموضح في مستندات التفويض لمزيد من المعلومات حول سلاسل طلب البحث وخصائص الاستجابة، الرؤية أحداث أنشطة تدقيق الجهاز. لأغراض تسهيل القراءة، يتم تنسيق المثال التالي باستخدام أسطر أسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

يحصل المثال التالي على تقرير عن جميع أحداث تدقيق الجهاز في حسابك. خلال آخر 180 يومًا تعرض معلمة طلب البحث maxResults 25 نتيجة لكل .

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

يحصل المثال التالي على تقرير عن جميع أحداث تدقيق الجهاز خلال آخر 180. أيام. تحدّد السمة customerId نوع تقرير العميل الذي يتم استرداده.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

استرداد أحداث تدقيق الجهاز حسب اسم الحدث

في بعض الحالات، قد ترغب في استرداد بيانات محددة الفعاليات مثل أحداث الأنشطة المريبة لإجراء ذلك، استخدِم طلب HTTP يتضمّن GET في النموذج التالي:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

يوضح المثال التالي كيفية استرداد جميع أحداث الأنشطة المريبة مستخدمو Android ضمن النطاق:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25