Google Drive API, aşağıdaki tabloda listelendiği gibi çeşitli indirme ve dışa aktarma işlemlerini destekler:
| İndirme işlemleri |
|
||||
| Dışa aktarma işlemleri |
|
Dosya içeriğini indirmeden veya dışa aktarmadan önce kullanıcıların files kaynağındaki capabilities.canDownload alanını kullanarak dosyayı indirebildiğini doğrulayın.
Blob ve Google Workspace dosyaları da dahil olmak üzere burada bahsedilen dosya türlerinin açıklamaları için Dosya türleri başlıklı makaleyi inceleyin.
Bu belgenin geri kalanında, bu tür indirme ve dışa aktarma işlemlerini gerçekleştirme ile ilgili ayrıntılı talimatlar verilmektedir.
Blob dosyası içeriğini indirme
Drive'da depolanan bir blob dosyasını indirmek için files.get yöntemini, indirilecek dosyanın kimliği ve alt=media URL parametresiyle birlikte kullanın. alt=media URL parametresi, sunucuya alternatif yanıt biçimi olarak içerik indirme isteğinde bulunulduğunu bildirir.
alt=media URL parametresi, tüm Google REST API'lerinde kullanılabilen bir sistem parametresidir. Drive API istemci kitaplığı kullanıyorsanız istemci kitaplığı yöntemi, temel HTTP isteğine alt=media URL parametresini eklediğinden bu parametreyi açıkça ayarlamanız gerekmez.
Aşağıdaki kod örneklerinde, dosya indirmek için files.get yönteminin nasıl kullanılacağı gösterilmektedir:
Apps Komut Dosyası
/**
* Downloads a file from Drive.
* @param {string} fileId The ID of the file to download.
* @return {Blob} The file content as a Blob.
*/
function downloadFile(fileId) {
var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '?alt=media';
var response = UrlFetchApp.fetch(url, {
headers: {
'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
}
});
return response.getBlob();
}
Java
Python
Node.js
PHP
.NET
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
- FILE_NAME: Çıkış dosyasının adı.
Uygulamanızdan başlatılan dosya indirme işlemleri, dosya içeriğine okuma erişimine izin veren bir kapsamla yetkilendirilmelidir. Örneğin, drive.readonly.metadata kapsamını kullanan bir uygulamanın dosya içeriklerini indirme yetkisi yoktur.
İstemci kitaplığı kod örnekleri, kullanıcıların tüm Drive dosyalarınızı görüntülemesine ve yönetmesine olanak tanıyan kısıtlanmış drive dosya kapsamını kullanır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.
owner izinlerine (Drive'ım dosyaları için) veya organizer izinlerine (ortak Drive dosyaları için) sahip kullanıcılar, DownloadRestrictionsMetadata nesnesi aracılığıyla indirmeyi kısıtlayabilir. Daha fazla bilgi için Kullanıcıların dosyanızı indirmesini, yazdırmasını veya kopyalamasını engelleme başlıklı makaleyi inceleyin.
Kötüye kullanım olarak tanımlanan dosyalar (ör. zararlı yazılımlar) yalnızca dosya sahibi tarafından indirilebilir.
Ayrıca, kullanıcının istenmeyen yazılım 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 belirtilen bölümünün indirilmesini ifade eder. Range üstbilgisiyle bayt aralığı kullanarak dosyanın indirmek istediğiniz kısmını belirtebilirsiniz. Örneğin:
Range: bytes=500-999
Blob dosyası içeriğini önceki bir sürümde indirme
Yalnızca "Daima sakla" olarak işaretlenen blob dosyası içeriği düzeltmelerini indirebilirsiniz. Bir revizyonu indirmek istiyorsanız önce "Daima sakla" olarak ayarlayın. Daha fazla bilgi için Otomatik silme işleminden kurtarmak üzere düzeltmeleri belirtme başlıklı makaleyi inceleyin.
Blob dosyalarının içeriğini daha önceki bir sürümde indirmek için revisions.get yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği, düzeltmenin kimliği ve alt=media URL parametresi yer alır. alt=media URL parametresi, sunucuya alternatif yanıt biçimi olarak içerik indirme isteğinde bulunulduğunu bildirir. files.get yöntemine benzer şekilde, revisions.get yöntemi de isteğe bağlı sorgu parametresi acknowledgeAbuse ve Range başlığını kabul eder. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?alt=media" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- REVISION_ID: İndirilecek düzeltmenin kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
- FILE_NAME: Çıkış dosyasının adı.
Blob dosyası içeriğini tarayıcıda indirme
Drive'da depolanan blob dosyalarının içeriğini API üzerinden değil, tarayıcıda indirmek için files kaynağının webContentLink alanını kullanın. Kullanıcının dosyaya indirme erişimi varsa dosyanın ve içeriğinin indirme bağlantısı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=webContentLink" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Aşağıdakini değiştirin:
- FILE_ID: İndirme bağlantısı alınacak dosyanın kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
Uzun süren işlemleri kullanarak blob dosyası içeriğini indirme
Uzun süren işlemleri (LRO) kullanarak blob dosyalarının içeriğini indirmek için files.download yöntemini indirilecek dosyanın kimliğiyle birlikte kullanın. İsteğe bağlı olarak düzeltmenin kimliğini ayarlayabilirsiniz.
Google Vids dosyalarını indirmenin tek yolu budur. Google Vids dosyalarını dışa aktarmaya çalıştığınızda fileNotExportable hatası alırsınız.
Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl
Aşağıdaki curl komutu bir LRO başlatır ve JSON yanıtı döndürür. Dosyayı indirmek veya bu LRO'yu yoklamak için içerik URL'sini almak üzere döndürülen kimliği kullanarak başka bir istekte bulunmanız gerekir. Ardından, dosyayı indirmek için bu URL'ye son bir curl isteği gönderebilirsiniz. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=video/mp4" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Length: 0" \
--header "Accept: application/json"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
Google Workspace doküman içeriğini dışa aktarma
Google Workspace dokümanı bayt içeriğini dışa aktarmak için dışa aktarılacak dosyanın kimliği ve doğru MIME türüyle birlikte files.export yöntemini kullanın. Dışa aktarılan içerik 10 MB ile sınırlıdır.
Aşağıdaki kod örneklerinde, files.export yönteminin Google Workspace belgesini PDF biçiminde dışa aktarmak için nasıl kullanılacağı gösterilmektedir:
Apps Komut Dosyası
/**
* Exports a Google Workspace document.
* @param {string} fileId The ID of the file to export.
* @param {string} mimeType The MIME type to export to.
* @return {Blob} The exported content as a Blob.
*/
function exportPdf(fileId, mimeType) {
var url = 'https://www.googleapis.com/drive/v3/files/' + fileId + '/export?mimeType=' + encodeURIComponent(mimeType);
var response = UrlFetchApp.fetch(url, {
headers: {
'Authorization': 'Bearer ' + ScriptApp.getOAuthToken()
}
});
return response.getBlob();
}
Java
Python
Node.js
PHP
.NET
curl
curl -L "https://www.googleapis.com/drive/v3/files/FILE_ID/export?mimeType=application/pdf" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--output "FILE_NAME.pdf"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
- FILE_NAME: Çıkış dosyasının adı.
İstemci kitaplığı kod örneklerinde, 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ı kullanılır. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.
Kod örneklerinde dışa aktarma MIME türü de application/pdf olarak belirtilir. Her Google Workspace belgesi için desteklenen tüm dışa aktarma MIME türlerinin tam listesi için Google Workspace belgeleri için dışa aktarma MIME türleri 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ıda dışa aktarmak için files kaynağının exportLinks alanını kullanın. Belge türüne bağlı olarak, kullanılabilen her MIME türü için dosyanın ve içeriğinin indirilebileceği bir bağlantı döndürülür. Kullanıcıyı bir URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,exportLinks" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Aşağıdakini değiştirin:
- FILE_ID: İndirme bağlantısı alınacak dosyanın kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
Google Workspace doküman içeriğini tarayıcıda daha eski bir sürümde dışa aktarma
Google Workspace doküman içeriğini tarayıcıda daha eski bir sürümde dışa aktarmak için revisions.get yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği ve dışa aktarma bağlantısı oluşturulacak düzeltmenin kimliği kullanılır. Bu bağlantıdan indirme işlemini gerçekleştirebilirsiniz. Kullanıcının dosyayı indirme erişimi varsa dosyanın ve içeriğinin indirme bağlantısı döndürülür. Kullanıcıyı bu URL'ye yönlendirebilir veya tıklanabilir bir bağlantı olarak sunabilirsiniz.
curl
curl "https://www.googleapis.com/drive/v3/files/FILE_ID/revisions/REVISION_ID?fields=id,name,exportLinks" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Accept: application/json"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- REVISION_ID: İndirilecek düzeltmenin kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
Uzun süren işlemleri kullanarak Google Workspace doküman içeriğini dışa aktarma
Uzun süren işlemler (LRO) kullanarak Google Workspace doküman içeriğini dışa aktarmak için files.download yöntemini kullanın. Bu yöntemde, indirilecek dosyanın kimliği ve düzeltme kimliği belirtilir. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl
Aşağıdaki curl komutu bir LRO başlatır ve JSON yanıtı döndürür. Dosyayı indirmek veya bu LRO'yu yoklamak için içerik URL'sini almak üzere döndürülen kimliği kullanarak başka bir istekte bulunmanız gerekir. Ardından, dosyayı indirmek için bu URL'ye son bir curl isteği gönderebilirsiniz. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl --request POST "https://www.googleapis.com/drive/v3/files/FILE_ID/download?mimeType=MIME_TYPE&revisionId=REVISION_ID" \
--header "Authorization: Bearer ACCESS_TOKEN" \
--header "Content-Length: 0" \
--header "Accept: application/json"
Aşağıdakini değiştirin:
- FILE_ID: İndirilecek dosyanın kimliği.
- MIME_TYPE: Dışa aktarılacak MIME türü.
- REVISION_ID: İndirilecek düzeltmenin kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.