Google Drive Activity API terdiri dari resource DriveActivity
, yang mewakili 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
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 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 tertentu,
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 representatif
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 tersebut, 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 berbagi dokumen, histori aktivitas untuk dokumen tersebut tidak hanya terlihat oleh pembuatnya, tetapi juga oleh pengguna terautentikasi yang dibagikan dokumen tersebut.
- Jika dokumen dibagikan kepada pengguna lalu dijadikan pribadi, pengguna yang diautentikasi dapat melihat semua histori aktivitas selama ia memiliki akses dan bahwa izinnya kini dibatasi.
- Jika dokumen tidak pernah dibagikan kepada pengguna, pengguna tidak akan 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 memulai Drive Activity API, pelajari cara membuat project dan mengotorisasi permintaan. Atau, langsung pelajari dan baca tentang aktivitas di referensi API.