Reports API: Laporan Aktivitas Audit Perangkat

Laporan aktivitas audit perangkat menampilkan informasi tentang aktivitas oleh semua perangkat di bawah Pengelolaan endpoint Google. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan permintaan parameter seperti email pengguna. Jangka waktu maksimum untuk setiap laporan adalah dalam 180 hari terakhir.

Laporan aktivitas audit perangkat hanya dapat digunakan untuk tujuan yang sah di sesuai dengan Perjanjian Pelanggan Anda. Lihat Membandingkan edisi Google Workspace untuk menemukan edisi yang menyertakan laporan tersebut.

Mengambil peristiwa audit perangkat untuk domain

Untuk mengambil semua peristiwa audit perangkat untuk semua pengguna dalam domain Anda, gunakan permintaan HTTP GET berikut dan menyertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Untuk informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Peristiwa Aktivitas Audit Perangkat. Untuk tujuan keterbacaan, contoh berikut diformat dengan pengembalian baris:

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

Contoh berikut mendapatkan laporan tentang semua peristiwa audit perangkat akun Anda selama 180 hari terakhir. Parameter kueri maxResults menampilkan 25 hasil per kami.

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

Contoh berikut mendapatkan laporan tentang semua aktivitas audit perangkat selama 180 tahun terakhir hari. customerId menentukan laporan pelanggan yang diambil.

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

Mengambil peristiwa audit perangkat menurut nama peristiwa

Dalam beberapa kasus, Anda mungkin ingin mendapatkan peristiwa, seperti peristiwa aktivitas mencurigakan. Untuk melakukannya, gunakan permintaan HTTP GET di format berikut:

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

Contoh berikut menunjukkan cara mengambil semua peristiwa aktivitas mencurigakan untuk Pengguna Android dalam domain:

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