Reports API: Laporan Aktivitas Drive

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, Anda menggunakan 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 boleh digunakan untuk tujuan yang sah di akun yang memiliki lisensi yang ditetapkan.

Untuk 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 Anda. Misalnya, Anda dapat meminta laporan yang mencantumkan 25 peristiwa 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 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, yaitu 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 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 dilakukan oleh pengguna yang ditentukan. 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 laporannya ingin Anda jalankan di kolom userKey, atau tentukan all untuk menjalankan laporan pada 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 untuk 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 menurut jenis peristiwa

Untuk mengambil laporan semua instance jenis peristiwa tertentu, seperti membuat atau mengedit dokumen, gunakan permintaan GET HTTP 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, respons 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 informasi selengkapnya tentang string kueri permintaan dan properti respons, 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": "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"
      }
      ]
     }
    ]
   },
  ]
 }