Reports API: Laporan Aktivitas Login

Laporan aktivitas {i>login<i} mengembalikan informasi tentang aktivitas {i>login<i} dari semua pengguna akun Anda. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan parameter khusus laporan seperti email pengguna. Tujuan jangka waktu maksimum untuk setiap laporan adalah 180 hari terakhir.

Laporan aktivitas login hanya dapat digunakan untuk tujuan yang sah sesuai dengan Perjanjian Pelanggan Anda.

Mengambil peristiwa login Google Workspace untuk domain

Untuk mengambil semua info masuk untuk semua layanan domain Anda, gunakan info berikut GET, dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Untuk informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API. Untuk tujuan keterbacaan, contoh berikut diformat dengan pengembalian baris:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/login?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

Contoh berikut mendapatkan laporan tentang semua peristiwa masuk akun Anda untuk 180 hari terakhir. Laporan ini menampilkan parameter kueri maxResults 25 hasil per halaman.

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

Contoh berikut mendapat laporan tentang semua peristiwa login pelanggan untuk 180 hari terakhir. customerId menentukan pelanggan mana yang dilaporkan yang akan diambil.

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

Mengambil peristiwa login Google Workspace menurut nama peristiwa

Dalam beberapa kasus, Anda mungkin ingin mendapatkan peristiwa, seperti upaya {i>login<i} yang berhasil dan mencurigakan. Untuk melakukannya, gunakan permintaan HTTP GET dari format berikut:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/login?maxResults=maximum number of events returned on a response page
&eventName=name of the login event
&filters=event parameter relational operator parameter value

Contoh berikut menunjukkan cara mengambil semua proses login yang berhasil dan mencurigakan untuk domain:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25