Bu kılavuzda, Drive API'yi kullanarak istemci tarafında şifrelenmiş (İTŞ) dosyaları toplu olarak içe aktarmak için özel bir araç oluşturmayla ilgili en iyi uygulamalar ele alınmaktadır.
Self servis taşımalar için Masaüstü için Drive'ı kullanma
Kullanıcılar, Masaüstü için Drive istemcisini kullanarak yerel makinesindeki dosyaları içe aktarabilir. İstemci tarafı şifrelemeyi tam olarak destekler ve kullanıcıların dosyaları kendilerinin şifreleyip yüklemesine olanak tanır. Bu kılavuzda açıklandığı gibi özel bir araç oluşturmak yalnızca büyük ölçekli, katılımsız veya çok kullanıcılı toplu içe aktarma işlemleri için gereklidir.
Başlamadan önce
Tek bir istemci tarafında şifrelenmiş dosyayı nasıl yöneteceğinizi anlamanız gerekir. Şifreleme, yükleme/indirme ve şifre çözme ile ilgili temel adımları öğrenmek için Bireysel İTŞ dosyalarını yönetme başlıklı makaleyi inceleyin. Bu adımlar arasında jeton oluşturma ve Anahtar Erişim Kontrol Listesi Hizmetiniz (KACLS) ile etkileşim kurma da yer alır.
Bir hizmet hesabı kullanarak kimlik doğrulama
Drive API ile etkileşimde bulunurken alan genelinde yetki verilmiş bir hizmet hesabı kullanın. Bu sayede uygulamanız kullanıcıların kimliğine bürünebilir. Böylece, kullanıcılar arasında programatik olarak geçiş yapabilir ve dosyaları doğrudan onlar adına yükleyebilirsiniz.
Dizin yapısını yeniden oluşturma
Mevcut dizin yapısını Drive'a yansıtmak için içe aktarma aracınızı kaynak dosya ve klasörlerde tekrar tekrar gezinerek tasarlayın. Üst düzey süreç şu şekildedir:
- Her kaynak dizin için karşılık gelen bir Drive klasörü oluşturun.
- Dizindeki dosyaları oluşturulan Drive klasörüne şifreleyin ve yükleyin.
- Alt dizinler için bu işlemi tekrarlayın.
Dosyaları doğru yere yükleme
Dosyaları her zaman doğru kullanıcının Drive'ım klasörüne veya erişilebilir bir ortak drive'a yükleyin. Bir ortak Drive veya klasör kimliğini bulmak için Drive web URL'sinden statik olarak ya da drives.list ve files.list yöntemlerini kullanarak dinamik olarak bulun.
Yinelenenleri önleme
Drive, aynı klasördeki birden fazla dosyanın aynı dosya adını paylaşmasına olanak tanır. Yüklemeden önce dosyalarınız için kimlik oluşturun. Bunu yapmak için Drive API files.generateIds yöntemini kullanabilirsiniz.
Bu önceden oluşturulmuş kimlikleri depolayarak içe aktarıcınız her dosyayı kendi kimliğine yüklemeyi deneyebilir. Bu kimliğe sahip bir dosya zaten varsa aracınız bu dosyayı güvenli bir şekilde atlayabilir. Önceden oluşturulmuş kimlikler kullanmak, aracınızın kilitlenmeden kurtulmasına yardımcı olur.
Her yüklemeden önce bir İTŞ jetonu isteyin
Anahtar sarmalama ve dosya yükleme işleminden hemen önce her dosya için generateCseToken işlevini çağırın. Bu yaklaşım, jetonun ilişkili meta verilerin mevcut durumunu doğru şekilde yansıtmasını sağlar. Bu durum değişebilir.
Büyük dosyalar için devam ettirilebilir yüklemeleri kullanma
Büyük dosyaları taşımak için Drive API devam ettirilebilir yüklemelerini kullanın. Devam ettirilebilir yüklemeler, ağ kesintileri sırasında dosyanın tamamını yeniden yüklemek yerine, içe aktarıcınızın başarısız olan parçaları yeniden denemesine olanak tanır.
Paylaşım izinlerini geri yükleme
Toplu içe aktarma aracınızın paylaşım izinlerini koruması gerekiyorsa önce dosyayı şifreleyip yükleyin, ardından permissions.create yöntemini çağırın.
Paylaşma izinleri, dosya yükleme işlemi sırasında uygulanmaz.
Jetonun son kullanma tarihini işleme
Uzun süren işlemler için komut dosyanız, jetonun süresinin dolması nedeniyle kimlik doğrulama hatalarıyla karşılaşabilir. Erişim jetonlarını otomatik olarak yenilemek ve yüklemeleri yeniden denemek için mantık uygulayın. Daha fazla bilgi için tek bir dosyanın nasıl şifrelenip yükleneceğini gösteren açık kaynak kodlu örneğe bakın.
İçe aktarılan dosyaları ayrıntılı bir şekilde doğrulayın
Toplu içe aktarma işleminden sonra kapsamlı doğrulama yapın. Google, dosyalarınızın şifresini çözemez ve dosyalarınızı sunucu tarafında doğrulayamaz. İçe aktarılan dosyaları doğrulama bölümünde tek tek dosyaları kontrol etmek için çeşitli yöntemler açıklanmaktadır.
Özellikle toplu içe aktarma işleminden sonra kullanışlı olan ve büyük ölçekte doğrulama yapmaya yarayan ek bir yöntem, resmi şifre çözme aracını kullanmaktır. Öncelikle, Google Paket Servisi'ni kullanarak şifrelenmiş içeriği Drive'dan indirin. Ardından, şifre çözücü aracını kullanarak şifre çözme işlemini deneyin. Bu işlem, şifresi çözülemeyen dosyaları belirlemeye yardımcı olur. Bu dosyalar, içe aktarma aracınızın şifreleme veya anahtar sarmalama mantığındaki olası sorunlara işaret eder.
Sınırları ve kotaları anlama
İstemci tarafında şifrelenmiş dosyalar, standart Drive sınırlarına ve kotalarına tabidir. Ortak Drive sınırları, genel dosya ve klasör sınırları ve kotanızı yönetme hakkında bilgi edinin. Ayrıca, içe aktarma aracınız, Anahtar Erişim Kontrol Listesi Hizmetiniz (KACLS) ve kimlik sağlayıcınızın (IdP) hız sınırlarını yönetmelidir.