Google Drive API'si, aşağıdaki tabloda listelenen çeşitli indirme ve dışa aktarma işlemi türlerini destekler:
İndirmeler |
|
|||
İhracat |
|
Dosya içeriğini indirmeden veya dışa aktarmadan önce kullanıcıların files
kaynağındaki capabilities.canDownload
alanını kullanarak dosyayı indirebileceklerini doğrulayın.
Bu kılavuzun geri kalanında, bu tür indirme ve dışa aktarma işlemlerini gerçekleştirmeyle ilgili ayrıntılı talimatlar sağlanmaktadır.
Blob dosyası içeriğini indir
Drive'da depolanan bir blob dosyasını indirmek için indirilecek dosyanın kimliği ve alt=media
URL parametresiyle files.get
yöntemini kullanın. alt=media
URL parametresi, sunucuya alternatif bir yanıt biçimi olarak içerik indirmenin istendiğini bildirir.
alt=media
URL parametresi, tüm Google REST API'lerinde kullanılabilen bir sistem parametresidir. Drive API için istemci kitaplığı kullanıyorsanız bu parametreyi açıkça ayarlamanız gerekmez.
Aşağıdaki kod örneğinde, Drive API istemci kitaplıklarıyla dosya indirmek için files.get
yönteminin nasıl kullanılacağı gösterilmektedir.
Java
Python
Node.js
PHP
.NET
Bu kod örneği, temel HTTP isteğine alt=media
URL parametresini ekleyen bir kitaplık yöntemi kullanır.
Uygulamanızdan başlatılan dosya indirme işlemleri, dosya içeriğine okuma erişimi sağlayan bir kapsamla yetkilendirilmelidir. Örneğin, drive.readonly.metadata
kapsamını kullanan bir uygulamanın dosya içeriklerini indirme yetkisi yoktur.
Bu kod örneği, kullanıcıların tüm Drive dosyalarınızı görüntülemesine ve yönetmesine olanak tanıyan kısıtlanmış "drive" dosyası kapsamını kullanır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleye bakın.
Düzenleme izinlerine sahip kullanıcılar, copyRequiresWriterPermission
alanını false
olarak ayarlayarak salt okuma erişimine sahip kullanıcıların indirme işlemlerini kısıtlayabilir.
Kötüye kullanım
olarak tanımlanan dosyalar (ör. zararlı yazılım) yalnızca dosya sahibi tarafından indirilebilir.
Buna ek olarak, kullanıcının istenmeyen yazılımları veya diğer kötüye kullanım amaçlı dosyaları indirme riskini kabul ettiğini belirtmek için get
sorgu parametresi acknowledgeAbuse=true
eklenmelidir. Uygulamanız bu sorgu parametresini kullanmadan önce kullanıcıyı etkileşimli olarak uyarmalıdır.
Kısmi indirme
Kısmi indirme, bir dosyanın yalnızca belirli bir bölümünün indirilmesini kapsar. Dosyanın indirmek istediğiniz bölümünü, Range
başlığıyla bir bayt aralığı kullanarak belirtebilirsiniz. Örneğin:
Range: bytes=500-999
Blob dosyası içeriğini önceki bir sürüme indirme
Blob dosyalarının içeriğini önceki bir sürümde indirmek için indirilecek dosyanın kimliğini, düzeltmenin kimliğini ve alt=media
URL parametresini içeren revisions.get
yöntemini kullanın.
alt=media
URL parametresi, sunucuya alternatif bir yanıt biçimi olarak içerik indirmenin istendiğini bildirir. files.get
yöntemine benzer şekilde revisions.get
yöntemi de isteğe bağlı acknowledgeAbuse
sorgu parametresini ve Range
başlığını kabul eder. Düzeltmeleri indirme hakkında daha fazla bilgi için Dosya düzeltmelerini indirme ve yayınlama bölümüne bakın.
Blob dosyası içeriğini bir tarayıcıya indirme
Drive'da depolanan blob dosyalarının içeriğini API yerine bir tarayıcıdan indirmek için files
kaynağının webContentLink
alanını kullanın. Kullanıcının dosyaya indirme erişimi varsa, dosyayı ve içeriğini indirmek için bir bağlantı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya URL'yi tıklanabilir bağlantı olarak sunabilirsiniz.
Google Workspace doküman içeriğini dışa aktarma
Google Workspace doküman bayt içeriğini dışa aktarmak için files.export
yöntemini kullanarak dışa aktarılacak dosyanın kimliğini ve doğru MIME türünü kullanın. Dışa aktarılan içerik 10 MB ile sınırlıdır.
Aşağıdaki kod örneğinde, bir Google Workspace dokümanını Drive API istemci kitaplıkları kullanarak PDF biçiminde dışa aktarmak için files.export
yönteminin nasıl kullanılacağı gösterilmektedir:
Java
Python
Node.js
PHP
.NET
Bu kod örneği, kullanıcıların tüm Drive dosyalarınızı görüntülemesine ve yönetmesine olanak tanıyan kısıtlanmış drive
kapsamını kullanmaktadır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleye bakın.
Kod örneğinde, dışa aktarma MIME türü de application/pdf
olarak tanımlanmıştır. Her Google Workspace dokümanında desteklenen tüm dışa aktarma MIME türlerinin tam listesi için Google Workspace dokümanlarında MIME türlerini dışa aktarma başlıklı makaleyi inceleyin.
Google Workspace dokümanı içeriğini tarayıcıda dışa aktarma
Google Workspace dokümanı içeriğini bir tarayıcı içinde dışa aktarmak için files
kaynağının exportLinks
alanını kullanın. Doküman türüne bağlı olarak, mevcut her MIME türü için dosyayı ve içeriğini indirmek için bir bağlantı döndürülür. Kullanıcıyı bir URL'ye yönlendirebilir veya URL'yi tıklanabilir bağlantı olarak sunabilirsiniz.
Google Workspace dokümanı içeriğini tarayıcıda önceki bir sürüme aktarma
Google Workspace doküman içeriğini tarayıcı üzerinden önceki bir sürüme aktarmak için, indirilecek dosyanın kimliğini ve düzeltmenin kimliğini içeren revisions.get
yöntemini kullanın. Kullanıcının dosyaya indirme erişimi varsa, dosyayı ve içeriğini indirmek için bir bağlantı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya URL'yi tıklanabilir bağlantı olarak sunabilirsiniz.