Reports API: Device Audit Activity Report

گزارش فعالیت حسابرسی دستگاه اطلاعات مربوط به فعالیت‌های همه دستگاه‌های تحت مدیریت نقطه پایانی Google را برمی‌گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای خاص گزارش مانند ایمیل کاربر استفاده می کند. حداکثر دوره زمانی برای هر گزارش 180 روز گذشته است.

گزارش فعالیت حسابرسی دستگاه ممکن است فقط برای اهداف قانونی مطابق با توافق نامه مشتری شما استفاده شود. برای یافتن نسخه‌هایی که شامل این گزارش‌ها می‌شوند، به مقایسه نسخه‌های Google Workspace مراجعه کنید.

رویدادهای ممیزی دستگاه را برای یک دامنه بازیابی کنید

برای بازیابی همه رویدادهای ممیزی دستگاه برای همه کاربران در دامنه خود، از درخواست GET HTTP زیر استفاده کنید و کد مجوز شرح داده شده در اسناد مجوز را اضافه کنید. برای اطلاعات بیشتر درباره رشته‌های درخواست درخواست و ویژگی‌های پاسخ، به رویدادهای فعالیت حسابرسی دستگاه مراجعه کنید. برای اهداف خوانایی، مثال زیر با برگرداندن خط قالب بندی شده است:

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 روز گذشته دریافت می‌کند. پارامتر query 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