Laporan aktivitas admin menampilkan informasi tentang aktivitas konsol Admin dari semua administrator akun Anda. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan parameter khusus laporan seperti nama administrator atau peristiwa konsol Admin tertentu. Jangka 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 juga berlaku untuk akun Google Workspace, Education, dan ISP.
Mengambil semua aktivitas administratif
Untuk mengambil laporan semua aktivitas administratif yang dilakukan untuk sebuah 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 menampilkan 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 jangka waktu maksimum untuk laporan. Dan 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 laporan akan diambil.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Mengambil semua aktivitas oleh 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 menampilkan 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 responsnya difilter untuk menampilkan aktivitas apa pun yang memiliki OLD_VALUE yang 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 informasi referensi nama peristiwa administrator. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API. Agar mudah dibaca, contoh berikut diformat dengan menampilkan 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 terkait perubahan 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 informasi referensi nama peristiwa administrator. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, lihat Referensi API. Agar mudah dibaca, contoh berikut diformat dengan menampilkan 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 akan menampilkan laporan. Untuk informasi eventName, lihat informasi referensi nama peristiwa administrator. Untuk informasi selengkapnya tentang string kueri URL dan properti respons permintaan, 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 requestor 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 requestor 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": ""
}
]
}
]
}
]
}