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 adalahuser
,domain
,drive
, danallDrives
. Pilihuser
ataudrive
keallDrives
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.