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 Anda saat aplikasi Anda melakukan operasi berikut:

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 menelusuri beberapa korpus memerlukan kemampuan drive bersama tambahan. Bagian lain dari dokumen ini menyoroti perubahan tambahan yang diperlukan untuk melakukan tugas ini.

Menelusuri konten di drive bersama

Gunakan metode list pada resource files untuk menemukan file pengguna di drive bersama. Untuk menelusuri drive bersama, lihat Menelusuri drive bersama.

Metode list berisi parameter kueri khusus drive bersama berikut:

  • driveId: ID drive bersama yang akan ditelusuri.

  • corpora: Isi item (file atau dokumen) yang berlaku untuk kueri. Isi yang didukung adalah user, domain, drive, dan allDrives. Sebaiknya gunakan user atau drive daripada allDrives untuk efisiensi. Secara default, korpus ditetapkan ke user.

  • includeItemsFromAllDrives: Apakah item Drive Saya dan drive bersama harus disertakan dalam hasil. Jika tidak ada atau ditetapkan ke salah (false), item drive bersama tidak akan ditampilkan.

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

Mode kueri berikut khusus untuk drive bersama:

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

Melacak perubahan di drive bersama

Gunakan metode list pada resource changes untuk melacak perubahan di drive bersama. Untuk mengetahui informasi selengkapnya, lihat Melacak perubahan untuk pengguna dan drive bersama.

Metode list berisi parameter kueri khusus drive bersama berikut:

  • driveId: Drive bersama tempat perubahan ditampilkan. Jika ditentukan, ID perubahan merujuk ke perubahan pada item dalam drive bersama yang memberikan status file saat ini. Untuk merujuk ke perubahan drive bersama tertentu, ID drive bersama dan ID perubahan harus digunakan sebagai ID.

  • includeItemsFromAllDrives: Apakah file atau perubahan drive bersama harus disertakan dalam daftar perubahan.

  • supportsAllDrives: Apakah aplikasi yang meminta mendukung drive bersama. Jika salah (false), item drive bersama, termasuk drive bersama dan file dalam drive bersama, tidak akan ditampilkan.

Mode kueri berikut khusus untuk drive bersama:

includeItemsFromAllDrives driveId Deskripsi kueri
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 Melacak perubahan untuk pengguna dan drive bersama.

Mengaktifkan dukungan drive bersama di UI Drive

Untuk mengakses konten drive bersama menggunakan UI Drive, pastikan Anda telah mencentang kotak Dukungan drive bersama di tab Integrasi UI Drive Google Drive API di Google Cloud Console. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi integrasi UI Drive.

Menggunakan Google Picker dengan drive bersama

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