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

يعرض تقرير نشاط تدقيق الجهاز معلومات عن الأنشطة التي تجريها جميع الأجهزة الخاضعة لإدارة نقاط النهاية من 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

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

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

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