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 ada dalam folder Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi respons berdasarkan
batasan seperti rentang waktu atau jenis tindakan, dan
dapat memilih untuk digabungkan aktivitasnya dalam
respons. Untuk informasi selengkapnya, lihat Membuat permintaan di Drive Activity API.
Respons
Respons terhadap permintaan adalah daftar aktivitas yang cocok dengan parameter tertentu,
dengan
resource DriveActivity yang mewakili setiap aktivitas:
Resource DriveActivity adalah kumpulan
objek Action, yang masing-masing
dapat berdiri sendiri 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 mengetahui 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 sebuah objek bergantung pada apakah perubahan tersebut, atau informasi tentang perubahan, terlihat oleh pengguna terautentikasi 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 dokumen tersebut tidak hanya dapat dilihat oleh pembuatnya, tetapi juga oleh pengguna terautentikasi yang diajak berbagi dokumen tersebut.
- Jika dokumen dibagikan kepada pengguna lalu diubah setelannya menjadi pribadi, pengguna yang diautentikasi dapat melihat semua histori aktivitas saat ia memiliki akses dan izinnya kini dibatasi.
- Jika dokumen tidak pernah dibagikan kepada pengguna, dia tidak dapat melihat histori aktivitas apa pun.
Memulai
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 mengizinkan permintaan. Atau, langsung pelajari dan baca tentang aktivitas di referensi API.