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 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 dokumen ini menjelaskan 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 menjadi cakupan kueri. Badan yang didukung adalah user, domain, drive, dan allDrives. Lebih memilih user atau drive daripada allDrives untuk efisiensi. Secara default, korpus disetel ke user.

  • includeItemsFromAllDrives: Apakah item Drive Saya dan drive bersama harus disertakan dalam hasil. Jika tidak ada atau disetel 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 disertakan dalam respons.

Mode kueri berikut khusus untuk drive bersama:

includeItemsFromAllDrives corpora Deskripsi kueri
true user Mengueri file yang telah diakses pengguna, termasuk file drive bersama dan file Drive Saya.
true domain Mengueri file yang dibagikan ke domain, termasuk file drive bersama dan file Drive Saya.
true drive Mengirimkan 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 penggunanya adalah anggota. Perhatikan bahwa respons mungkin menyertakan incompleteSearch:true, yang menunjukkan bahwa beberapa korpus tidak ditelusuri untuk permintaan ini.

Memantau perubahan di drive bersama

Gunakan metode list pada resource changes untuk memantau perubahan di drive bersama. Untuk 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 pada perubahan pada item dalam drive bersama yang memberikan status file saat ini. Untuk merujuk pada 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 pada Google Drive API di Konsol Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi integrasi UI Drive.

Menggunakan Pemilih Google dengan drive bersama

Pemilih Google 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.