Laporan aktivitas Drive memberikan informasi tentang aktivitas pengguna saat mereka mengelola, mengubah, dan membagikan file di Google Drive di Google Workspace. Misalnya, Anda dapat menggunakan laporan aktivitas Drive untuk mendapatkan daftar semua dokumen Drive baru yang dibuat oleh pengguna tertentu selama rentang tanggal yang ditentukan. Anda dapat menggunakan informasi ini untuk mendapatkan insight tentang pengelolaan konten yang lebih baik dan kemungkinan kebocoran data. Untuk mendapatkan laporan, gunakan permintaan endpoint laporan dasar dengan parameter khusus laporan seperti alamat email pengguna atau jenis perubahan Google Drive tertentu. Laporan dapat menyertakan data hingga 180 hari terakhir.
Laporan aktivitas Google Drive hanya dapat digunakan untuk tujuan yang sah di akun yang memiliki lisensi.
Untuk mengetahui informasi tentang string kueri permintaan dan properti respons, lihat Referensi API. Untuk mengetahui informasi tentang peristiwa tertentu yang terkait dengan Google Drive, lihat Nama peristiwa Drive.
Mengambil peristiwa Google Drive untuk domain
Anda dapat menggunakan laporan aktivitas Drive untuk mencantumkan informasi tentang dokumen Drive. Misalnya, Anda dapat meminta laporan yang mencantumkan 25 peristiwa Drive terbaru di akun Anda, yang mencakup hingga 180 hari. Untuk mendapatkan laporan ini, dapatkan token otorisasi seperti yang dijelaskan dalam
panduan otorisasi, lalu gunakan
permintaan GET
HTTP berikut:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Anda dapat melihat contoh respons untuk panggilan API ini.
Contoh berikut mengambil laporan semua peristiwa Drive selama 180 hari terakhir, periode maksimum.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Mengambil peristiwa Google Drive berdasarkan pengguna
Untuk mengambil laporan aktivitas Google Drive pengguna tertentu, gunakan permintaan HTTP GET
dengan token otorisasi yang dijelaskan dalam panduan panduan otorisasi.
Kolom userKey
adalah alamat email utama pengguna dalam laporan, atau
all
untuk semua pengguna.
Contoh berikut mengambil laporan yang mencantumkan semua perubahan yang dibuat oleh pengguna tertentu. Untuk contoh respons API, lihat contoh respons JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Mengambil peristiwa Google Drive untuk drive bersama
Anda dapat mengambil laporan aktivitas Google Drive untuk drive bersama tertentu menggunakan permintaan GET
HTTP dengan token otorisasi yang dijelaskan dalam panduan otorisasi. Tentukan
alamat email pengguna yang ingin Anda jalankan laporan di kolom userKey
,
atau tentukan all
untuk menjalankan laporan tentang semua pengguna.
Contoh berikut mengambil laporan semua perubahan untuk drive bersama tertentu. Untuk contoh respons API, lihat contoh respons JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Untuk mengambil peristiwa pada drive bersama, filter menggunakan doc_type
. Contoh berikut mengambil peristiwa yang memengaruhi semua drive bersama:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Untuk mengambil peristiwa perubahan keanggotaan, tentukan peristiwa shared_drive_membership_change
. Contoh berikut mengambil semua penambahan anggota ke drive bersama:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Mengambil peristiwa Google Drive berdasarkan jenis peristiwa
Untuk mengambil laporan semua instance dari jenis peristiwa tertentu, seperti membuat atau mengedit dokumen, gunakan permintaan HTTP GET
dengan token otorisasi yang dijelaskan dalam panduan otorisasi.
Kolom userKey
adalah alamat email utama pengguna dalam laporan, atau
all
untuk semua pengguna.
Contoh berikut mengambil laporan semua aktivitas pembuatan dokumentasi akun. Untuk contoh respons API, lihat contoh respons JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Contoh respons JSON
Saat Anda membuat permintaan HTTP GET
ke API, respons yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, responsnya akan menampilkan laporan untuk Drive. Laporan ini juga tersedia di
konsol Admin. Untuk mengetahui informasi selengkapnya, lihat
pusat bantuan Admin Google Workspace.
Untuk informasi eventName
, lihat referensi Nama peristiwa Drive. Untuk mengetahui informasi selengkapnya tentang string kueri dan properti respons permintaan, baca Referensi API.
{ "kind": "reports#auditActivities", "nextPageToken": "next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2014-03-17T15:39:18.460Z", "uniqQualifier": "report's unique ID", "applicationName": "drive", "customerId": "ABC123xyz" }, "actor": { "callerType": "USER", "email": "kim@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in an OAuth 2LO request" }, "ownerDomain": "domain of the source owner", "ipAddress": "user's IP address", "events": [ { "type": "access", "name": "edit", "parameters": [ { "name": "primary_event", "boolValue": true }, { "name": "owner_is_shared_drive", "boolValue": false }, { "name": "doc_id", "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8" }, { "name": "doc_title", "value": "Meeting notes" }, { "name": "doc_type", "value": "document" }, { "name": "owner", "value": "mary@example.com" } ] } ] }, ] }