Google Drive API'nin en son sürümü v3'tür. v3'teki performans daha iyidir çünkü aramaları yalnızca bir alan alt kümesi döndürür. İhtiyacınız yoksa geçerli sürümü kullanın v2 koleksiyonunu kullanabilirsiniz. v2 kullanıyorsanız şunları göz önünde bulundurun: v3'e geçiyorum. Taşıma işlemi için Drive API v3'e taşıma başlıklı makaleyi inceleyin. Sürüm farklılıklarının tam listesi için bkz. Drive API v2 ve v3 karşılaştırması referans.
v2'yi kullanmaya devam etmek istiyorsanız v3'teki bazı talimatların nasıl yapılacağını öğrenmek için Drive API v2 değişikliği rehberi bölümüne bakın kılavuzlar v2 geliştiricileri için değiştirilmelidir.
Drive API v3 iyileştirmeleri hakkında daha fazla bilgi edinmek için Google mühendislerinin yeni API tasarımını tartıştıkları aşağıdaki videoyu izleyin.
V3 iyileştirmeleri
v3, performansı optimize etmek ve API davranışı karmaşıklığını azaltmak için şunları sağlar: önceki API sürümüne göre bazı iyileştirmeler yapıldı:
- Dosyalar ve ortak Drive'lar için yapılan aramalar varsayılan olarak kaynakların tamamını döndürmez.
Genellikle kullanılan alanların yalnızca bir alt kümesi döndürülür. Ayrıntılı bilgi için
fields
,files.list
yöntemini inceleyin vedrives.list
yöntemi. - Yanıt döndüren hemen hemen tüm yöntemler için artık
fields
gereklidir parametresinden sonra bir değer girin.fields
gerektiren tüm yöntemlerin listesi için bkz. Drive API referansı. - Yinelenen özelliklere sahip kaynaklar kaldırıldı. Birkaç örnek:
files.list
yöntemi,Children
veParents
koleksiyonları, bu nedenle 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ı belirler vefiles.list
içinden uygulama verilerini döndürür yöntemini vechanges.list
ancak performansı yavaşlatır. v3'te,drive.appdata
kapsamını ayarlarsınız. vespaces=appDataFolder
sorgu parametresini şu isteğe ayarlayın: uygulama verileri. - Tüm güncelleme işlemleri PUT yerine PATCH yöntemini kullanır.
- Google Dokümanlar'ı dışa aktarmak için
files.export
yöntemini kullanabilirsiniz. changes.list
yönteminin davranışı farklıdır. Değişiklik kimlikleri yerine, opak sayfa jetonları. Değişiklik koleksiyonunu yoklamak için öncechanges.getStartPageToken
yöntemini kullanın. Sonraki sorgulardachanges.list
yöntemi,newStartPageToken
değerini döndürür.- Güncelleme yöntemleri artık yazılabilir olmayan alanları belirten istekleri reddediyor.
- v2
exportFormats
veimportFormats
alanlarıabout
kaynağı şunların listeleridir: izin verilen içe veya dışa aktarma biçimleridir. v3'te ise bunlar, sunucularınızın olası hedefleri tüm desteklenen içe veya dışa aktarma işlemlerine uygulayabilirsiniz. - v2
appdata
veappfolder
takma adları artık v3'teappDataFolder
. properties
kaynağı v3'ten kaldırıldı. İlgili içeriği oluşturmak için kullanılanfiles
kaynağındaproperties
alanı var içeren bir yapılandırmadır.properties
alanı, herkese açık değerini içeriyor mülkleri veappProperties
alanı özel mülkler içerir, bu nedenle görünürlük alanına gerek yoktur.files
kaynağındakimodifiedTime
alanı son olarak güncellenir Herhangi bir kullanıcı dosyayı değiştirdiyse. v2'demodifiedDate
alanı yalnızca değiştirilebilirsetModifiedDate
alanını ayarlarsanız güncellenmeye devam eder.files
kaynağındakiviewedByMeTime
alanı otomatik olarak çalışmıyor güncelleyin.- Google Dokümanlar biçimlerini içe aktarmak için uygun hedefi (
mimeType
) ayarlarsınız. yazması gerekir. 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 mevcuttu ancak şu anda
istek parametresi olarak kullanılabilir. Örnek:
- Sürüm 2'de, bir
children.delete
üst klasöre koyun. - Sürüm 3'te, alt öğede
files.update
kullanıyorsunuz.?removeParents=parent_id
içeriyor.
- Sürüm 2'de, bir
Diğer farklılıklar
Alanlar ve parametre adları v3'te farklıdır. Buna örnek olarak aşağıdakiler verilebilir:
name
özelliği,files
kaynağındakititle
öğesinin yerini alır.Time
, tüm tarih ve saat alanları içinDate
yerine sonektir.- Liste işlemleri, sonuç grubunu içermek için
items
alanını kullanmaz. İlgili içeriği oluşturmak için kullanılan kaynak türü, sonuçlar için bir alan sağlar (files
veyachanges
) tıklayın.