Google Drive Activity API terdiri dari
resource DriveActivity, yang
merepresentasikan perubahan yang dibuat 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
baik untuk item Drive tertentu maupun untuk semua yang ada dalam folder
Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi respons berdasarkan batasan seperti rentang waktu atau jenis tindakan, dan Anda dapat memilih agar aktivitas digabungkan dalam respons. Untuk mengetahui informasi selengkapnya, lihat Membuat permintaan di Drive Activity API.
Tanggapan
Respons terhadap permintaan adalah daftar aktivitas yang cocok dengan parameter tertentu,
dengan resource
DriveActivity mewakili setiap aktivitas:
Resource DriveActivity adalah kumpulan objek
Action, yang masing-masing berisi
peristiwa seperti peristiwa. Action menyertakan
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
terpadu
atau TimeRange, 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 API ini. Baik Drive Activity API melaporkan perubahan tertentu pada objek bergantung pada apakah perubahan, atau informasi tentang perubahan, terlihat oleh pengguna yang diautentikasi dalam 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 tidak hanya dapat dilihat oleh kreator, tetapi juga oleh pengguna terautentikasi yang diajak berbagi dokumen.
- Jika dokumen dibagikan kepada pengguna lalu dibuat menjadi pribadi, pengguna yang terautentikasi dapat melihat semua histori aktivitas saat mereka memiliki akses dan izin kini dibatasi.
- Jika dokumen tidak pernah dibagikan kepada pengguna, pengguna tidak dapat melihat histori aktivitas apa pun.
Memulai
Untuk mengoptimalkan Drive Activity API, integrasikan aplikasi Anda dengan Google Drive API terlebih dahulu. Untuk memulai Drive Activity API, pelajari cara membuat project dan memberi otorisasi permintaan. Atau, pelajari dan baca tentang aktivitas di referensi API.