Dokumen ini memberikan ringkasan Google Drive Activity API.
Drive Activity API memungkinkan Anda membuat kueri untuk peristiwa terbaru. Anda dapat mengambil histori mendetail dari semua aktivitas, termasuk informasi terperinci tentang setiap peristiwa. Hal ini berguna untuk tugas seperti audit karena Anda dapat mengambil aktivitas yang tepat yang menyertakan informasi ActionDetail, Actor, dan Target.
Drive Activity API terdiri dari
DriveActivity resource, yang mewakili
perubahan yang dilakukan pada objek dalam Google Drive pengguna, dan metode
activity.query, yang memungkinkan Anda mengambil
informasi tentang perubahan tersebut.
Permintaan
Aplikasi Anda meminta data aktivitas pengguna menggunakan metode activity.query. Anda dapat meminta aktivitas untuk item Drive tertentu atau untuk semua yang terdapat di folder Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi
respons menggunakan filter seperti rentang waktu
atau jenis tindakan, dan Anda dapat memilih untuk menggabungkan aktivitas dalam respons. Untuk mengetahui informasi selengkapnya,
lihat Membuat permintaan di Google Drive Activity API.
Respons
Respons berisi daftar aktivitas yang cocok dengan parameter yang diberikan, dengan
resource DriveActivity yang mewakili setiap
aktivitas:
Resource DriveActivity adalah kumpulan objek
Action, yang masing-masing bersifat mandiri
seperti peristiwa. Action mencakup ActionDetail (seperti Create atau Edit), Actor (seperti User atau Administrator), Target (seperti DriveItem atau Drive), dan
Timestamp
atau TimeRange.
Resource DriveActivity juga berisi informasi ringkasan, seperti setiap
Actor dan Target dari semua tindakan, Timestamp atau TimeRange terpadu,
dan ActionDetail yang paling penting atau representatif dari Action.
Untuk mengetahui informasi selengkapnya, lihat model data Drive Activity API.
Visibilitas histori aktivitas
Beberapa aktivitas di Drive mungkin tidak dilaporkan saat Anda menggunakan Drive Activity API. Apakah API melaporkan perubahan tertentu pada objek bergantung pada apakah perubahan, atau informasi tentang perubahan tersebut, terlihat oleh pengguna yang diautentikasi di aplikasi Anda.
Visibilitas didasarkan pada izin yang ditetapkan untuk objek. Ada beberapa skenario saat file dan folder dibagikan di Drive:
Jika penulis membagikan dokumen, histori aktivitas untuk dokumen tersebut akan terlihat oleh pembuat dan pengguna yang diajak berbagi.
Jika dokumen dibagikan kepada pengguna, lalu dijadikan pribadi, pengguna dapat melihat semua histori aktivitas dari periode saat mereka memiliki akses, tetapi tidak setelah izin dibatasi.
Jika dokumen tidak pernah dibagikan kepada pengguna, pengguna tidak dapat melihat histori aktivitas apa pun.
Topik terkait
- Untuk memaksimalkan Drive Activity API, integrasikan aplikasi Anda dengan Google Drive API terlebih dahulu
- Untuk mempelajari pengembangan dengan Google Workspace API, termasuk membuat project atau menangani autentikasi dan otorisasi, lihat Mengembangkan di Google Workspace.
- Untuk mempelajari aktivitas, lihat referensi API.