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

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