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 bergantung pada fungsi aplikasi Anda.

Untuk memulai, Anda perlu menyertakan parameter kueri supportsAllDrives=true dalam permintaan 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

API Drive 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 didesain untuk menangani file di drive bersama.

Aplikasi yang membaca atau mengubah izin, melacak perubahan, atau perlu melakukan penelusuran di beberapa korpora 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 — Badan item (file/dokumen) tempat kueri diterapkan. Isi yang didukung adalah user, domain, drive, dan allDrives. Pilih user atau drive ke allDrives untuk efisiensi.

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

Mode kueri berikut dikhususkan untuk drive bersama:

includeItemsFromAllDrives corpora Keterangan Permintaan
true user Mengajukan kueri terhadap file yang telah diakses pengguna, termasuk drive bersama dan file Drive Saya.
true drive Mengkueri semua item dalam drive bersama yang ditentukan. driveId harus ditentukan dalam permintaan.
true allDrives Meminta file yang telah diakses pengguna dan semua drive bersama tempat mereka menjadi anggota. Perhatikan bahwa responsnya mungkin menyertakan incompleteSearch : true, yang menunjukkan bahwa beberapa korpora tidak ditelusuri untuk permintaan ini.
true domain Meminta file yang dibagikan ke domain, termasuk drive bersama dan file 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 permintaan mendukung drive bersama atau tidak. 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 dikhususkan 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 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 mengetahui informasi selengkapnya, 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 tentang cara membuat drive bersama dan mengelola izin drive bersama.