Pengantar Google Drive Activity API

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:

Penjelasan Aktivitas Drive.

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.