Google Drive Activity API terdiri dari
DriveActivity, yang
menunjukkan 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 atau untuk semua yang ada dalam Drive
folder tersebut. Untuk permintaan tertentu, Anda dapat memilih membatasi respons
batasan seperti rentang waktu atau jenis tindakan, dan Anda
dapat memilih untuk menggabungkan aktivitas di
yang dihasilkan. 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
mandiri seperti peristiwa. Action mencakup
ActionDetail (seperti Create
atau Edit), dan Actor (seperti User
atau Administrator), suatu Target (seperti
sebagai DriveItem atau Drive), dan
Timestamp
atau TimeRange.
Resource DriveActivity juga berisi
ringkasan informasi, seperti setiap
Actor dan
Target dari semua tindakan,
Timestamp
atau TimeRange, dan notifikasi
penting atau representatif
ActionDetail dari
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 yang diberikan pada suatu objek bergantung pada apakah perubahan, atau informasi tentang perubahan itu, terlihat oleh 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 terlihat tidak hanya oleh pembuat, tetapi juga oleh pengguna yang diautentikasi dengan siapa saja file itu dibagikan.
- Jika dokumen dibagikan kepada pengguna dan kemudian dijadikan pribadi, dokumen yang pengguna dapat melihat semua histori aktivitas saat mereka memiliki akses dan izin tersebut kini dibatasi.
- Jika dokumen tidak pernah dibagikan kepada pengguna, pengguna tidak dapat melihat aktivitas apa pun sejarah.
Mulai
Untuk mendapatkan hasil maksimal dari Drive Activity API, integrasikan aplikasi Anda dengan Google Drive API terlebih dahulu. Untuk memulai Drive Activity API, pelajari cara membuat project dan permintaan otorisasi. Atau, langsung dan baca aktivitas di Referensi API.