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 menerapkan dukungan drive bersama di aplikasi Anda. Kompleksitas penerapan Anda bergantung pada fungsi aplikasi Anda.

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

Drive API 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 beberapa korpora memerlukan fungsi tambahan drive bersama. 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 dan mode kueri khusus Shared Drive 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 menerapkan kueri. Badan yang didukung adalah user, domain, drive, dan allDrives. Lebih memilih user atau drive daripada allDrives untuk efisiensi.

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

Mode kueri berikut khusus untuk drive bersama:

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

Memantau perubahan di drive bersama

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

  • driveId — Drive bersama tempat perubahan dikembalikan. Jika ditentukan, ID perubahan merujuk pada perubahan dalam drive bersama, bukan perubahan pada file yang ditampilkan kepada pengguna. Untuk merujuk pada perubahan drive bersama tertentu, ID drive bersama dan ID perubahan harus digunakan sebagai ID.
  • supportsAllDrives — Apakah aplikasi yang meminta mendukung drive bersama atau tidak. Jika salah (false), 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 menjadi anggota.
true Ya Perubahan mencerminkan perubahan pada drive bersama tertentu yang ditentukan dan item di dalam drive bersama tersebut.

Untuk mengetahui 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 Kelola drive bersama untuk mendapatkan bantuan tentang cara membuat drive bersama dan mengelola izin drive bersama.