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

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