Versi Google Drive API terbaru adalah v3. Performa di v3 lebih baik karena penelusuran hanya menampilkan subset kolom. Gunakan versi saat ini kecuali Anda memerlukan koleksi v2. Jika Anda menggunakan v2, pertimbangkan untuk bermigrasi ke v3. Untuk melakukan migrasi, lihat Bermigrasi ke Drive API v3. Untuk mengetahui daftar lengkap perbedaan versi, lihat referensi perbandingan Drive API v2 dan v3.
Jika Anda ingin terus menggunakan v2, lihat amendemen Panduan untuk Drive API v2 untuk mempelajari bagaimana beberapa petunjuk dalam panduan v3 harus diubah untuk developer v2.
Untuk mempelajari lebih lanjut peningkatan Drive API v3, Anda dapat menonton video berikut dari engineer Google yang membahas desain API baru.
Peningkatan V3
Untuk mengoptimalkan performa dan mengurangi kompleksitas perilaku API, v3 memberikan peningkatan ini dibandingkan versi API sebelumnya:
- Secara default, penelusuran file dan drive bersama tidak menampilkan resource lengkap. Hanya sebagian kolom yang umum digunakan yang akan ditampilkan. Untuk detail selengkapnya tentang
fields
, lihat metodefiles.list
dan metodedrives.list
. - Hampir semua metode yang menampilkan respons sekarang memerlukan parameter
fields
. Untuk daftar semua metode yang memerlukanfields
, lihat referensi Drive API. - Resource yang memiliki kemampuan duplikat telah dihapus. Beberapa contohnya:
- Metode
files.list
memiliki fungsi yang sama seperti koleksiChildren
danParents
, sehingga akan dihapus dari v3. - Metode
Realtime.*
telah dihapus.
- Metode
- Data Aplikasi tidak ditampilkan secara default dalam penelusuran. Di v2, Anda dapat menetapkan
cakupan
drive.appdata
, dan menampilkan data aplikasi dari metodefiles.list
dan metodechanges.list
, tetapi ini memperlambat performanya. Di v3, Anda menetapkan cakupandrive.appdata
, dan juga menetapkan parameter kuerispaces=appDataFolder
untuk meminta data aplikasi. - Semua operasi update menggunakan PATCH, bukan PUT.
- Untuk mengekspor Google Dokumen, gunakan metode
files.export
. - Perilaku metode
changes.list
berbeda. Gunakan token halaman buram, bukan ID perubahan. Untuk melakukan polling kumpulan perubahan, panggil metodechanges.getStartPageToken
terlebih dahulu untuk nilai awal. Untuk kueri berikutnya, metodechanges.list
akan menampilkan nilainewStartPageToken
. - Metode update kini menolak permintaan yang menentukan kolom yang tidak dapat ditulis.
- Kolom
exportFormats
danimportFormats
v2 di resourceabout
adalah daftar format impor atau ekspor yang diizinkan. Pada v3, keduanya adalah peta jenis MIME dari kemungkinan target untuk semua impor atau ekspor yang didukung. - Alias
appdata
danappfolder
v2 sekarang menjadiappDataFolder
di v3. - Resource
properties
dihapus dari v3. Resourcefiles
memiliki kolomproperties
yang berisi key-value pair benar. Kolomproperties
berisi properti publik, dan kolomappProperties
berisi properti pribadi sehingga kolom visibilitas tidak diperlukan. - Kolom
modifiedTime
dalam resourcefiles
diperbarui saat terakhir kali siapa pun mengubah file. Di v2, kolommodifiedDate
hanya dapat diubah saat update jika Anda menetapkan kolomsetModifiedDate
. - Kolom
viewedByMeTime
di resourcefiles
tidak otomatis diupdate. - Untuk mengimpor format Google Dokumen, Anda harus menetapkan
mimeType
target yang sesuai dalam isi resource. Di v2, Anda menetapkan?convert=true
. - Operasi impor menampilkan error 400 jika formatnya tidak didukung.
- Pembaca dan pengomentar tidak dapat melihat izin.
- Alias
me
untuk izin dihapus. - Beberapa fungsi tersedia sebagai bagian dari resource permintaan, tetapi
tersedia sebagai parameter permintaan. Misalnya:
- Di v2, Anda dapat menggunakan
children.delete
untuk menghapus file turunan dari folder induk. - Di v3, Anda menggunakan
files.update
pada turunan dengan?removeParents=parent_id
di URL.
- Di v2, Anda dapat menggunakan
Perbedaan lainnya
Kolom dan nama parameter berbeda di v3. Contohnya antara lain:
- Properti
name
menggantikantitle
di resourcefiles
. Time
adalah akhiran untuk semua kolom tanggal dan waktu, bukanDate
.- Operasi daftar tidak menggunakan kolom
items
untuk memuat kumpulan hasil. Jenis resource menyediakan kolom untuk hasil (sepertifiles
atauchanges
).