Reports API: Laporan Aktivitas Drive

Laporan aktivitas Drive memberikan informasi tentang aktivitas pengguna aktivitas saat mereka mengelola, mengubah, dan berbagi 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 tertentu. Anda dapat menggunakan informasi ini untuk mendapatkan wawasan 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 hukum di akun yang memiliki lisensi yang ditetapkan.

Untuk informasi tentang string kueri permintaan dan properti respons, lihat Referensi API. Sebagai 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 listingan laporan 25 aktivitas Drive terbaru akun Anda, yang mencakup hingga 180 hari. Untuk mendapatkan laporan ini, dapatkan token otorisasi seperti yang dijelaskan dalam panduan otorisasi, lalu gunakan permintaan HTTP GET 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 Drive peristiwa selama 180 hari terakhir, periode maksimum.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

Mengambil peristiwa Google Drive menurut pengguna

Untuk mengambil laporan aktivitas Google Drive pengguna tertentu, gunakan Permintaan GET HTTP dengan token otorisasi yang dijelaskan di panduan otorisasi. Kolom userKey adalah alamat email utama pengguna di laporan, atau all untuk semua pengguna.

Contoh berikut mengambil laporan yang mencantumkan semua perubahan yang dilakukan oleh pengguna tertentu. Untuk contoh respons API, lihat contoh respons JSON.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/[e-mail]
/applications/drive

Mengambil peristiwa Google Drive untuk drive bersama

Anda dapat mengambil laporan aktivitas Google Drive untuk item tertentu yang dibagikan drive menggunakan permintaan GET HTTP dengan token otorisasi yang dijelaskan dalam panduan otorisasi. Tentukan alamat email pengguna yang ingin Anda gunakan untuk menjalankan laporan di kolom userKey, atau tentukan all untuk menjalankan laporan pada semua pengguna.

Contoh berikut mengambil laporan semua perubahan untuk properti bersama tertentu {i>drive<i}. 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 untuk drive bersama, filter menggunakan doc_type. Tujuan 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 untuk perubahan keanggotaan, tentukan shared_drive_membership_change peristiwa. 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 menurut jenis peristiwa

Untuk mengambil laporan tentang semua instance dari jenis peristiwa tertentu, seperti membuat atau mengedit dokumen, gunakan permintaan GET HTTP dengan otorisasi token yang dijelaskan dalam panduan otorisasi. Kolom userKey adalah alamat email utama pengguna di laporan, atau all untuk semua pengguna.

Contoh berikut mengambil laporan semua pembuatan dokumentasi akun aktivitas Anda. 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 GET HTTP ke API, respons yang berhasil akan menampilkan Kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan laporan untuk Drive. Laporan ini juga tersedia di Konsol Admin. Untuk informasi selengkapnya, lihat Pusat bantuan Admin Google Workspace. Untuk informasi eventName, lihat Nama peristiwa Drive alamat IP internal. Untuk informasi selengkapnya tentang string kueri permintaan dan metode properti respons yang sama, lihat 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": "[e-mail]",
   "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": "[e-mail]"
      }
      ]
     }
    ]
   },
  ]
 }