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 agar aktivitas digabungkan dalam
respons. Untuk mengetahui 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
yang mewakili setiap aktivitas:
Resource DriveActivity
adalah kumpulan
objek Action
, yang masing-masing
dimuat secara 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 API ini. Apakah Drive Activity API melaporkan perubahan yang diberikan pada sebuah 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 akan terlihat oleh pembuat, tetapi juga oleh pengguna terautentikasi yang diajak berbagi dokumen tersebut.
- Jika dokumen dibagikan kepada pengguna lalu dijadikan pribadi, pengguna terautentikasi dapat melihat semua histori aktivitas saat ia memiliki akses dan izinnya 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 permintaan otorisasi. Atau, langsung saja dan baca tentang aktivitas di referensi API.