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 |
|
Drive API'de blob dosyası, Google Workspace dokümanının aksine Google Drive'da depolanan tüm ham ikili program dosyalarını (ör. resimler, videolar ve PDF'ler) ifade eder. JavaScript'in Blob nesnesini ifade etmez. Blob ve Google Workspace dosyaları da dahil olmak üzere burada bahsedilen dosya türlerinin ayrıntılı açıklamaları için Dosya türleri başlıklı makaleyi inceleyin.
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.
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 indirilecek dosyanın kimliği ve alt system
parametresi ile files.get yöntemini kullanın.
alt=media parametresi, sunucuya alternatif yanıt biçimi olarak içerik indirme isteğinde bulunulduğunu bildirir.
alt sistem parametresi tüm Google REST API'lerinde kullanılabilir. Bir Drive API istemci kitaplığı kullanıyorsanız istemci kitaplığı yöntemi, alt=media parametresini temel HTTP isteğine eklediği için 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 acknowledgeAbuse sorgu parametresi true olarak ayarlanmalıdır. Uygulamanız, bu sorgu parametresini kullanmadan önce kullanıcıyı etkileşimli olarak uyarmalıdır.
Bellekteki dosya verilerine erişme
Uygulamanızın, dosya verilerine yerel diske kaydetmek yerine doğrudan bellekte (ör. bayt arabelleği olarak) erişmesi gerekiyorsa istemci kitaplığı isteğini ayarlayabilir veya döndürülen akışı işleyebilirsiniz:
Node.js: Node.js istemci kitaplığı, dosya içeriğini varsayılan olarak
Readableakışı olarak döndürür. Dosyayı yerel diske kaydetmek için:const fs = require('fs'); const dest = fs.createWriteStream('/path/to/dest/file.ext'); const response = await service.files.get( { fileId, alt: 'media' }, { responseType: 'stream' } ); response.data .on('end', () => { console.log('Download complete.'); }) .on('error', (err) => { console.error('Error downloading file.', err); }) .pipe(dest);Alternatif olarak, verileri akış yerine doğrudan bellekte
ArrayBufferolarak döndürmek için istek seçeneklerinizderesponseTypeparametresini ayarlayın:const file = await service.files.get({ fileId, alt: 'media', }, { responseType: 'arraybuffer' }); // Convert the ArrayBuffer to a Node.js Buffer object. const buffer = Buffer.from(file.data);Python: Blob dosyası indirmek için Python kod örneği, indirme parçalarını zaten bellek içi
io.BytesIO()nesnesine yazar. Ham baytlara erişmek içinfile.getvalue()işlevini çağırın.Java: Blob dosyası indirmek için kullanılan Java kodu örneğinde, indirilen baytları bellekte yakalamak için
java.io.ByteArrayOutputStreamkullanılır. Ham bayt dizisine erişmek içinoutputStream.toByteArray()öğesini kullanın..NET: Bir blob dosyası indirmek için C# kodu örneğinde
System.IO.MemoryStreamkullanılır. Temel bayt dizisine erişmek içinstream.ToArray()öğesini kullanın.Apps Komut Dosyası: Bir blob dosyası indirmek için kullanılan Apps Komut Dosyası kod örneği,
response.getBlob()yöntemini kullanarakBlobnesnesi döndürür.getBytes()yöntemini kullanarak bunu bayt dizisine dönüştürün.
Kısmi indirme
Kısmi indirme, bir dosyanın yalnızca belirtilen bölümünün indirilmesini ifade eder. Range üstbilgisiyle byte aralığı kullanarak dosyanın indirmek istediğiniz bölümünü belirtebilirsiniz. Örneğin:
Range: bytes=500-999
Blob dosyası içeriğini önceki bir sürümde indirme
Blob dosyalarının içeriğini ö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 sistem parametresi yer alır.
alt=media 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 acknowledgeAbuse sorgu parametresini ve Range başlığını kabul eder.
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.
Revizyon indirme hakkında 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 indirilecek dosyanın kimliğiyle birlikte files.download yöntemini 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 uzun süreli işlemi başlatır ve JSON yanıtı döndürür. Dosyayı indirmek veya bu LRO'yu yoklamak için döndürülen kimliği kullanarak içerik URL'sini almak üzere 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ının bayt içeriğini dışa aktarmak için dışa aktarılacak dosyanın kimliği ve doğru MIME türüyle 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 ö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 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.
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 eksiksiz 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 URL'yi 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 belirtilir. 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 indirilmesi gereken dosyanın kimliği ve düzeltme kimliğiyle birlikte kullanın. Daha fazla bilgi için Uzun süren işlemleri yönetme başlıklı makaleyi inceleyin.
curl
Aşağıdaki curl komutu bir uzun süreli işlemi başlatır ve JSON yanıtı döndürür. Dosyayı indirmek veya bu LRO'yu yoklamak için döndürülen kimliği kullanarak içerik URL'sini almak üzere 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.