En son Google Drive API sürümü, v3'tür. Aramalar yalnızca alanların bir alt kümesini döndürdüğünden, v3'teki performans daha iyidir. v2 koleksiyonuna ihtiyacınız yoksa mevcut sürümü kullanın. v2'yi kullanıyorsanız v3'e geçebilirsiniz. Taşıma işlemi için Drive API v3'e Taşıma başlıklı makaleye bakın. Sürüm farklılıklarının tam listesi için Drive API v2 ve v3 karşılaştırma referansı bölümüne bakın.
v2'yi kullanmaya devam etmek istiyorsanız v3 kılavuzlarındaki bazı talimatların v2 geliştiricileri için nasıl değiştirilmesi gerektiğini öğrenmek üzere Drive API v2 Kılavuzu değişikliğine bakın.
Drive API v3'teki iyileştirmeler hakkında daha fazla bilgi edinmek için Google mühendislerinin yeni API tasarımını tartıştığı aşağıdaki videoyu izleyebilirsiniz.
V3 iyileştirmeleri
Performansı optimize etmek ve API davranışının karmaşıklığını azaltmak için v3, önceki API sürümüne kıyasla aşağıdaki iyileştirmeleri sunar:
- Dosya ve ortak Drive aramaları varsayılan olarak kaynakların tamamını döndürmez. Yalnızca sık kullanılan alanların bir alt kümesi döndürülür.
fields
hakkında daha fazla bilgi içinfiles.list
yöntemini vedrives.list
yöntemini inceleyin. - Yanıt döndüren neredeyse tüm yöntemler artık
fields
parametresini gerektirir.fields
gerektiren tüm yöntemlerin listesi için Drive API referansı'na bakın. - Yinelenen özelliklere sahip kaynaklar kaldırıldı. Bazı örnekler:
files.list
yöntemi,Children
veParents
koleksiyonlarıyla aynı işlevi sağladığından v3'ten kaldırılır.Realtime.*
yöntemleri kaldırıldı.
- Uygulama verileri aramalarda varsayılan olarak döndürülmez. v2'de,
drive.appdata
kapsamını ayarlayabilirsiniz. Bu ayar,files.list
vechanges.list
yönteminden uygulama verilerini döndürür ancak performansı yavaşlatır. v3'tedrive.appdata
kapsamını ayarlarsınız ve ayrıcaspaces=appDataFolder
sorgu parametresini uygulama verilerini isteyecek şekilde ayarlarsınız. - Tüm güncelleme işlemleri PUT yerine YAMA kullanır.
- Google dokümanlarını dışa aktarmak için
files.export
yöntemini kullanın. changes.list
yönteminin davranışı farklıdır. Değişiklik kimlikleri yerine, opak sayfa jetonları kullanın. Değişiklik koleksiyonunu yoklamak için önce başlangıç değeri içinchanges.getStartPageToken
yöntemini çağırın. Sonraki sorgulardachanges.list
yönteminewStartPageToken
değerini döndürür.- Güncelleme yöntemleri artık yazılamayan alanları belirten istekleri reddeder.
about
kaynağındaki v2exportFormats
veimportFormats
alanları, izin verilen içe veya dışa aktarma biçimlerinin listesidir. v3'te bunlar, desteklenen tüm içe veya dışa aktarma işlemlerine yönelik olası hedeflerin MIME türü eşlemeleridir.- v2
appdata
veappfolder
takma adları v3'teappDataFolder
olarak değiştirildi. properties
kaynağı v3'ten kaldırıldı.files
kaynağında gerçek anahtar/değer çiftlerini içerenproperties
alanı bulunur.properties
alanı herkese açık mülkleri,appProperties
alanı ise özel mülkleri içerir. Bu nedenle görünürlük alanına gerek yoktur.files
kaynağındakimodifiedTime
alanı, herhangi bir kullanıcı dosyayı en son değiştirdiğinde güncellenir. v2'demodifiedDate
alanı yalnızcasetModifiedDate
alanını ayarlarsanız güncelleme durumunda değişebilir.files
kaynağındakiviewedByMeTime
alanı otomatik olarak güncellenmez.- Google Dokümanlar biçimlerini içe aktarmak için kaynak gövdesinde uygun hedefi
mimeType
ayarlarsınız. v2'de?convert=true
değerini ayarladınız. - Biçim desteklenmiyorsa içe aktarma işlemleri 400 hatası döndürür.
- Okuyucular ve yorumcular izinleri görüntüleyemez.
- İzinler için
me
takma adı kaldırıldı. - Bazı işlevler istek kaynağının bir parçası olarak kullanılabilir durumdaydı, ancak bunun yerine istek parametresi olarak kullanılabilir durumdaydı. Örneğin:
- v2'de bir alt dosyayı üst klasörden kaldırmak için
children.delete
kullanabilirsiniz. - v3'te, alt öğede URL'de
?removeParents=parent_id
ilefiles.update
ifadesini kullanıyorsunuz.
- v2'de bir alt dosyayı üst klasörden kaldırmak için
Diğer farklılıklar
v3'te alanlar ve parametre adları farklıdır. Buna örnek olarak aşağıdakiler verilebilir:
name
özelliği,files
kaynağındatitle
öğesinin yerini alır.Time
, tüm tarih ve saat alanları içinDate
yerine sonektir.- Liste işlemleri, sonuç kümesini içermek için
items
alanını kullanmaz. Kaynak türü, sonuçlar için bir alan sağlar (files
veyachanges
gibi).