Laporan aktivitas admin menampilkan informasi tentang aktivitas konsol Admin semua administrator akun Anda. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan parameter khusus laporan seperti nama administrator atau peristiwa konsol Admin tertentu. Periode waktu maksimum untuk setiap laporan adalah 180 hari terakhir.
Laporan aktivitas admin hanya dapat digunakan untuk tujuan yang sah sesuai dengan Perjanjian Pelanggan Anda. Laporan ini berlaku untuk akun Google Workspace, Education, dan ISP.
Mengambil semua aktivitas administratif
Untuk mengambil laporan semua aktivitas administratif yang dilakukan untuk akun, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan
properti respons, lihat
Referensi API.
Agar mudah dibaca, contoh berikut diformat dengan pemisahan baris:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
Contoh berikut mendapatkan laporan tentang semua aktivitas administratif akun Anda selama 180 hari terakhir, yang merupakan periode waktu maksimum untuk laporan.
String kueri maxResults menentukan bahwa laporan ini berisi dua
peristiwa per halaman laporan. Untuk contoh respons API, lihat
contoh respons JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Contoh berikut mendapatkan laporan tentang semua aktivitas administratif pelanggan selama 180 hari terakhir. customerId menentukan pelanggan mana yang datanya akan diambil untuk laporan.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Mengambil semua aktivitas menurut administrator
Untuk mengambil laporan semua aktivitas konsol Admin yang dilakukan oleh
administrator tertentu, gunakan permintaan HTTP GET berikut dan
sertakan token otorisasi yang dijelaskan dalam
dokumentasi otorisasi. userKey adalah alamat email utama administrator dalam laporan. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API.
Agar mudah dibaca, contoh berikut diformat dengan pemisahan baris:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
Contoh berikut mendapatkan laporan tentang semua perubahan pada aplikasi Konsol Admin yang dilakukan oleh john@example.com, dan respons difilter untuk menampilkan aktivitas apa pun yang memiliki OLD_VALUE sama dengan ALLOW_CAMERA. Untuk contoh respons API, lihat Contoh respons JSON.
Untuk mengetahui informasi tentang aktivitas, lihat
nama peristiwa
administrator:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Mengambil semua aktivitas menurut nama peristiwa
Untuk mengambil laporan semua aktivitas untuk nama peristiwa tertentu, gunakan
permintaan HTTP GET berikut dan sertakan token otorisasi
yang dijelaskan dalam
dokumentasi otorisasi. Untuk informasi eventName, lihat
administrator
informasi referensi nama peristiwa. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API.
Agar mudah dibaca, contoh berikut diformat dengan pemisahan baris:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
Contoh berikut mengambil laporan untuk semua instance konsol Admin yang mengubah nama belakang pengguna. Untuk contoh respons API, lihat contoh respons JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Mengambil semua aktivitas menurut peristiwa dan administrator
Untuk mengambil laporan semua perubahan konsol Admin untuk nama peristiwa tertentu yang dilakukan oleh administrator tertentu, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. userKey adalah alamat email utama administrator dalam laporan. Untuk informasi eventName, lihat
administrator
informasi referensi nama peristiwa. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API.
Agar mudah dibaca, contoh berikut diformat dengan pemisahan baris:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
Contoh berikut mengambil laporan untuk semua perubahan konsol Admin pada nama belakang pengguna tertentu yang dilakukan oleh john@example.com. Untuk contoh respons API, lihat
contoh respons JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Contoh respons JSON laporan aktivitas admin
Respons yang berhasil akan menampilkan
kode status HTTP 200.
Bersama dengan kode status, respons menampilkan laporan. Untuk
eventName informasi, lihat
informasi referensi nama peristiwa
administrator. Untuk mengetahui informasi selengkapnya tentang string kueri URL permintaan dan properti respons, lihat Referensi API.
{ "kind": "reports#auditActivities", "nextPageToken": "the next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "report's unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in OAuth 2LO requests" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CHANGE_GROUP_SETTING", "parameters": [ { "name": "SETTING_NAME", "value": "WHO_CAN_JOIN", "intValue": "integer value of parameter", "boolValue": "boolean value of parameter" } ] } ] }, { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "reports unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requester in an OAuth 2LO request" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CREATE_GROUP", "parameters": [ { "name": "GROUP_EMAIL", "value": "helpdesk@example.com", "intValue": "", "boolValue": "" } ] } ] } ] }