Pengantar Google Drive Activity API

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:

Penjelasan Aktivitas Drive.

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.