Google Drive Activity API terdiri dari
resource DriveActivity, 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 dalam folder
Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi respons berdasarkan
batasan seperti rentang waktu atau jenis tindakan, dan Anda
dapat memilih untuk menggabungkan aktivitas dalam
respons. Untuk informasi selengkapnya, lihat Membuat permintaan di Drive Activity API.
Respons
Respons terhadap permintaan adalah daftar aktivitas yang cocok dengan parameter yang diberikan,
dengan
resource DriveActivity 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 mewakili
Action.
Untuk informasi selengkapnya, lihat model data Drive Activity API.
Visibilitas histori aktivitas
Beberapa aktivitas di Drive mungkin tidak dilaporkan saat Anda menggunakan API ini. Apakah Drive Activity 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 tidak hanya dapat dilihat oleh pembuatnya, tetapi juga oleh pengguna terautentikasi yang diajak berbagi.
- Jika dokumen dibagikan kepada pengguna, lalu dijadikan pribadi, pengguna yang diautentikasi 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.
Mulai
Untuk mendapatkan hasil maksimal dari Drive Activity API, integrasikan aplikasi Anda dengan Google Drive API terlebih dahulu. Untuk mulai menggunakan Drive Activity API, pelajari cara membuat project dan memberi otorisasi permintaan. Atau, langsung baca aktivitas di referensi API.