Pengantar Google Drive Activity API

Google Drive Activity API terdiri dari resource DriveActivity, yang merepresentasikan 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 baik untuk item Drive tertentu atau untuk semua yang ada di folder Drive. Untuk permintaan tertentu, Anda dapat memilih untuk membatasi respons berdasarkan batasan seperti rentang waktu atau jenis tindakan, dan Anda 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 merepresentasikan setiap aktivitas:

Penjelasan Aktivitas Drive.

Resource DriveActivity adalah kumpulan objek Action, yang masing-masing 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 yang terpadu, dan ActionDetail Action yang paling penting atau representatif.

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 tertentu pada 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 dapat dilihat tidak hanya oleh pembuat, tetapi juga oleh pengguna yang diajak berbagi dan telah diautentikasi.
  • Jika dokumen dibagikan kepada pengguna, lalu disetel ke pribadi, pengguna yang diautentikasi dapat melihat semua histori aktivitas saat mereka memiliki akses dan bahwa izin kini dibatasi.
  • Jika dokumen tidak pernah dibagikan kepada pengguna, pengguna tidak dapat melihat histori aktivitas.

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 memberi otorisasi permintaan. Atau, langsung saja pelajari aktivitas dalam referensi API.