Mengimplementasikan dukungan drive bersama

Drive bersama mengikuti model organisasi, berbagi, dan kepemilikan yang berbeda dari Drive Saya. Jika aplikasi Anda akan membuat dan mengelola file di drive bersama, Anda harus mengimplementasikan dukungan drive bersama di aplikasi. Kompleksitas penerapan Anda bergantung pada fungsi aplikasi Anda.

Untuk memulai, Anda perlu menyertakan parameter kueri supportsAllDrives=true dalam permintaan Anda saat aplikasi menjalankan operasi yang tercantum di bawah ini:

API Drive v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Parameter supportsAllDrives=true memberi tahu Google Drive bahwa aplikasi Anda dirancang untuk menangani file di drive bersama.

Aplikasi yang membaca atau mengubah izin, melacak perubahan, atau perlu menelusuri di beberapa korpus memerlukan fungsi drive bersama tambahan. Bagian selanjutnya dari dokumen ini menyoroti perubahan tambahan yang diperlukan untuk melakukan tugas ini.

Menelusuri konten di drive bersama

Gunakan metode files.list untuk menelusuri drive bersama. Bagian ini membahas kolom khusus drive bersama dalam metode files.list. Untuk menelusuri drive bersama, lihat Menelusuri file dan folder.

Metode files.list berisi kolom khusus drive bersama dan mode kueri berikut:

  • driveId — ID drive bersama yang akan ditelusuri.

  • includeItemsFromAllDrives — Apakah item drive bersama harus disertakan dalam hasil. Jika tidak ada atau disetel ke salah (false), item drive bersama tidak akan ditampilkan.

  • corpora — Isi item (file/dokumen) yang menjadi tempat penerapan kueri. Isi yang didukung adalah user, domain, drive, dan allDrives. Pilih user atau drive daripada allDrives untuk efisiensi.

  • supportsAllDrives — Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama. Jika nilai salah, item drive bersama tidak disertakan dalam respons.

Mode kueri berikut khusus untuk drive bersama:

includeItemsFromAllDrives corpora Keterangan Permintaan
true user Mengkueri file yang telah diakses pengguna, termasuk file drive bersama dan Drive Saya.
true drive Mengajukan kueri untuk semua item di drive bersama yang ditentukan. driveId harus ditentukan dalam permintaan.
true allDrives Mengkueri file yang telah diakses pengguna dan semua drive bersama tempat pengguna tersebut menjadi anggota. Perhatikan bahwa respons dapat menyertakan incompleteSearch : true, yang menunjukkan bahwa beberapa korpus tidak ditelusuri untuk permintaan ini.
true domain Mengkueri file yang dibagikan ke domain, termasuk file drive bersama dan Drive Saya.

Memantau perubahan di drive bersama

Gunakan metode changes.list untuk melacak perubahan di drive bersama. Bagian ini membahas kolom khusus drive bersama dalam metode changes.list. Untuk informasi selengkapnya, lihat Melacak perubahan untuk pengguna dan drive bersama. Metode changes.list berisi kolom khusus drive bersama dan mode kueri berikut:

  • driveId — Drive bersama tempat perubahan ditampilkan. Jika ditentukan, ID perubahan merujuk pada perubahan dalam drive bersama, bukan perubahan pada file yang ditampilkan kepada pengguna. Untuk merujuk ke perubahan drive bersama tertentu, ID drive bersama dan ID perubahan harus digunakan sebagai ID.
  • supportsAllDrives — Apakah aplikasi yang meminta mendukung drive bersama. Jika salah, item drive bersama, termasuk drive bersama dan file dalam drive bersama, tidak akan ditampilkan.
  • includeItemsFromAllDrives — Apakah file atau perubahan drive bersama harus disertakan dalam daftar perubahan.

Mode kueri berikut khusus untuk drive bersama:

includeItemsFromAllDrives driveId Keterangan Permintaan
true Tidak Perubahan mencerminkan perubahan pada file di dalam atau di luar drive bersama yang telah diakses pengguna, serta perubahan pada drive bersama tempat pengguna adalah anggota.
true Ya Perubahan mencerminkan perubahan pada drive bersama tertentu yang ditentukan dan item di dalam drive bersama tersebut.

Untuk detail tambahan tentang perilaku log perubahan, lihat Log Perubahan.

Mengaktifkan dukungan drive bersama di UI Drive

Untuk mengakses konten drive bersama menggunakan UI Drive, pastikan Anda telah mencentang "Dukungan drive bersama" di Konsol API Google. Untuk informasi lebih lanjut, lihat Mengonfigurasi integrasi UI Drive.

Menggunakan pemilih file dengan drive bersama

Pemilih file mendukung pemilihan item di drive bersama. Untuk mengetahui detail tentang cara mengaktifkan dukungan drive bersama dan menambahkan tampilan drive bersama di pemilih file, lihat Google Picker API.

Langkah berikutnya

Lanjutkan ke Mengelola drive bersama untuk mendapatkan bantuan terkait cara membuat drive bersama dan mengelola izin drive bersama.