Drive API v2 ve v3 karşılaştırma kılavuzu

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 ve drives.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 ve Parents 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 ve files.list içinden uygulama verilerini döndürür yöntemini ve changes.list ancak performansı yavaşlatır. v3'te, drive.appdata kapsamını ayarlarsınız. ve spaces=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 önce changes.getStartPageToken yöntemini kullanın. Sonraki sorgularda changes.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 ve importFormats 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 ve appfolder takma adları artık v3'te appDataFolder.
  • properties kaynağı v3'ten kaldırıldı. İlgili içeriği oluşturmak için kullanılan files kaynağında properties alanı var içeren bir yapılandırmadır. properties alanı, herkese açık değerini içeriyor mülkleri ve appProperties alanı özel mülkler içerir, bu nedenle görünürlük alanına gerek yoktur.
  • files kaynağındaki modifiedTime alanı son olarak güncellenir Herhangi bir kullanıcı dosyayı değiştirdiyse. v2'de modifiedDate alanı yalnızca değiştirilebilir setModifiedDate alanını ayarlarsanız güncellenmeye devam eder.
  • files kaynağındaki viewedByMeTime 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, birchildren.delete üst klasöre koyun.
    • Sürüm 3'te, alt öğede files.update kullanıyorsunuz. ?removeParents=parent_id içeriyor.

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ğındaki title öğesinin yerini alır.
  • Time, tüm tarih ve saat alanları için Date 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 veya changes) tıklayın.