Laporan aktivitas login menampilkan informasi tentang aktivitas login semua pengguna akun Anda. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan parameter khusus laporan seperti email pengguna. Jangka waktu maksimum untuk setiap laporan adalah 180 hari terakhir.
Laporan aktivitas login hanya boleh digunakan untuk tujuan yang sah sesuai dengan Perjanjian Pelanggan Anda.
Mengambil peristiwa login Google Workspace untuk domain
Untuk mengambil semua login untuk semua layanan domain Anda, gunakan permintaan HTTP GET berikut 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 pemisahan 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 login akun Anda selama
180 hari terakhir. Parameter kueri maxResults memiliki laporan ini yang menampilkan
25 hasil per halaman.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
Contoh berikut mendapatkan laporan tentang semua peristiwa login pelanggan selama
180 hari terakhir. customerId menentukan pelanggan yang akan
diambil laporannya.
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 mengambil peristiwa tertentu, seperti login yang berhasil yang mencurigakan. Untuk melakukannya, gunakan permintaan HTTP GET dengan
bentuk 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 login yang berhasil dan mencurigakan untuk suatu domain:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25