Dokumen ini memberikan ringkasan Google Drive Activity API.
Drive Activity API memungkinkan Anda membuat kueri untuk peristiwa terbaru. Anda dapat mengambil histori mendetail semua aktivitas, termasuk informasi terperinci tentang setiap peristiwa. Hal ini berguna untuk tugas seperti audit karena Anda dapat mengambil aktivitas
yang tepat yang mencakup informasi ActionDetail, Actor, dan Target.
Drive Activity API terdiri dari resource
DriveActivity, yang merepresentasikan
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 ada di folder Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi
respons menggunakan filter seperti rentang waktu
atau jenis tindakan, dan Anda dapat memilih agar aktivitas digabungkan 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
setiap aktivitas diwakili oleh resource DriveActivity:
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, 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 dapat dilihat oleh pembuat dan pengguna yang diajak berbagi.
Jika dokumen dibagikan kepada pengguna, lalu disetel ke 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.
Topik terkait
- Untuk mendapatkan hasil maksimal dari Drive Activity API, integrasikan aplikasi Anda terlebih dahulu dengan Google Drive API
- 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.