Mengimplementasikan dukungan drive bersama

Drive bersama mengikuti pengaturan, berbagi, dan kepemilikan yang berbeda lain dari Drive Saya. Jika aplikasi Anda akan membuat dan mengelola file di file bersama drive bersama, Anda harus menerapkan dukungan drive bersama dalam aplikasi Anda. Kompleksitas dari implementasi Anda bergantung pada fungsi aplikasi.

Untuk memulai, Anda perlu menyertakan parameter kueri supportsAllDrives=true di permintaan Anda saat aplikasi melakukan 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 dirancang untuk menangani file di drive bersama.

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

Menelusuri konten di drive bersama

Gunakan metode files.list untuk menelusuri {i>shared drive<i} secara bersama-sama. Bagian ini membahas kolom khusus drive bersama di Metode files.list. Untuk menelusuri drive bersama, lihat Menelusuri file dan folder.

Metode files.list berisi hal-hal yang dibagikan berikut kolom khusus drive dan mode kueri:

  • driveId — ID drive bersama yang akan ditelusuri.

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

  • corpora — Isi item (file/dokumen) ke tempat kueri akan diterapkan. Isi yang didukung adalah user, domain, drive, dan allDrives. Pilih user atau drive hingga 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 Meminta semua item di drive bersama yang ditentukan. driveId harus ditentukan dalam permintaan.
true allDrives Membuat kueri file yang telah diakses pengguna dan semua drive bersama tempat mereka menjadi anggota. Perhatikan bahwa respons mungkin menyertakan incompleteSearch : true, yang menunjukkan bahwa beberapa korpora tidak ditelusuri untuk permintaan ini.
true domain Meminta 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 {i>drive<i} bersama. Bagian ini membahas kolom khusus drive bersama di Metode changes.list. Untuk informasi selengkapnya, lihat Pantau perubahan untuk pengguna dan drive bersama. Metode changes.list berisi hal-hal yang dibagikan berikut kolom khusus drive dan mode kueri:

  • driveId — Drive bersama tempat perubahan ditampilkan. Jika tertentu, ID perubahan merujuk pada perubahan dalam {i>drive<i} bersama, bukan perubahan pada file yang ditampilkan kepada pengguna. Untuk merujuk ke drive bersama tertentu perubahan, ID drive bersama dan ID perubahan harus digunakan sebagai ID.
  • supportsAllDrives — Apakah aplikasi yang meminta mendukung fitur berbagi {i>drive<i}. 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 menjadi anggota.
true Ya Perubahan mencerminkan perubahan pada drive bersama tertentu yang telah 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 memeriksa "Dukungan drive bersama" di Konsol API Google. Untuk informasi selengkapnya, lihat Mengonfigurasi integrasi UI Drive.

Menggunakan pemilih file dengan drive bersama

Alat pilih file mendukung pemilihan item di drive bersama. Untuk mengetahui detail terkait 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 membantu membuat drive bersama dan mengelola izin drive bersama.