Google Drive API mendukung beberapa jenis tindakan download dan ekspor, seperti yang tercantum dalam tabel berikut:
Download konten |
|
|||
Ekspor |
|
Sebelum mendownload atau mengekspor konten file, pastikan pengguna dapat mendownload file menggunakan kolom capabilities.canDownload
pada resource files
.
Bagian selanjutnya dari panduan ini berisi petunjuk mendetail untuk melakukan jenis tindakan download dan ekspor tersebut.
Download konten file blob
Untuk mendownload file blob yang disimpan di Drive, gunakan metode files.get
dengan ID file yang akan didownload
dan parameter URL alt=media
. Parameter URL alt=media
memberi tahu
server bahwa download konten diminta sebagai format respons
alternatif.
Parameter URL alt=media
adalah parameter sistem yang tersedia di semua Google REST API. Jika menggunakan library klien untuk
Drive API, Anda tidak perlu menetapkan parameter ini secara eksplisit.
Contoh kode berikut menunjukkan cara menggunakan metode files.get
untuk mendownload file dengan library klien Drive API.
Java
Python
Node.js
PHP
.NET
Contoh kode ini menggunakan metode library yang menambahkan parameter URL alt=media
ke permintaan HTTP yang mendasarinya.
Download file yang dimulai dari aplikasi Anda harus diizinkan dengan cakupan yang memungkinkan
akses baca ke konten file. Misalnya, aplikasi yang menggunakan
cakupan drive.readonly.metadata
tidak diizinkan untuk mendownload konten file.
Contoh kode ini menggunakan cakupan file "drive" yang dibatasi, sehingga pengguna dapat melihat dan mengelola semua file Drive Anda. Untuk mempelajari cakupan Drive lebih lanjut, lihat Memilih cakupan API Google Drive.
Pengguna yang memiliki izin edit dapat membatasi download yang dilakukan oleh pengguna hanya baca dengan menetapkan kolom copyRequiresWriterPermission
ke false
.
File yang diidentifikasi sebagai disalahgunakan (seperti software berbahaya) hanya dapat didownload oleh pemilik file.
Selain itu, parameter kueri get
acknowledgeAbuse=true
harus disertakan
untuk menunjukkan bahwa pengguna telah memahami risiko mendownload software yang mungkin
tidak diinginkan atau file penyalahgunaan lainnya. Aplikasi Anda harus secara interaktif
memperingatkan pengguna sebelum menggunakan parameter kueri ini.
Download sebagian
Download sebagian berarti hanya mendownload sebagian file tertentu. Anda dapat menentukan bagian file yang ingin didownload menggunakan rentang byte dengan header Range
. Contoh:
Range: bytes=500-999
Download konten file blob pada versi sebelumnya
Untuk mendownload konten file blob pada versi sebelumnya, gunakan
metode revisions.get
dengan ID
file yang akan didownload, ID revisi, dan parameter URL alt=media
.
Parameter URL alt=media
memberi tahu server bahwa download konten
diminta sebagai format respons alternatif. Serupa dengan files.get
, metode revisions.get
juga menerima parameter kueri opsional
acknowledgeAbuse
dan header Range
. Untuk informasi selengkapnya tentang mendownload
revisi, lihat Mendownload dan memublikasikan revisi
file.
Mendownload konten file blob di browser
Untuk mendownload konten file blob yang disimpan di Drive dalam
browser, bukan melalui API, gunakan
kolom
webContentLink
dari
resource files
. Jika pengguna memiliki akses
download ke file, link untuk mendownload file beserta isinya
akan ditampilkan. Anda dapat mengalihkan pengguna ke URL ini, atau menawarkannya sebagai link yang dapat diklik.
Mengekspor konten dokumen Google Workspace
Untuk mengekspor konten byte dokumen Google Workspace, gunakan metode files.export
dengan ID file yang akan diekspor
dan jenis MIME yang benar. Konten yang diekspor
dibatasi hingga 10 MB.
Contoh kode berikut menunjukkan cara menggunakan metode files.export
untuk mengekspor
dokumen Google Workspace dalam format PDF menggunakan library klien
Drive API:
Java
Python
Node.js
PHP
.NET
Contoh kode ini menggunakan cakupan drive
yang dibatasi yang memungkinkan pengguna melihat dan mengelola semua file Drive Anda. Untuk mempelajari cakupan Drive lebih lanjut, lihat Memilih cakupan API Google Drive.
Contoh kode ini juga mendeklarasikan jenis MIME ekspor sebagai application/pdf
. Untuk mengetahui daftar lengkap semua jenis MIME ekspor yang didukung untuk setiap dokumen Google Workspace, lihat Mengekspor jenis MIME untuk dokumen Google Workspace.
Mengekspor konten dokumen Google Workspace di browser
Untuk mengekspor konten dokumen Google Workspace dalam browser, gunakan kolom exportLinks
dari resource files
. Bergantung pada jenis dokumen, link untuk mendownload file dan isinya akan ditampilkan untuk setiap jenis MIME yang tersedia. Anda dapat mengalihkan pengguna ke URL, atau menawarkannya sebagai link yang dapat diklik.
Mengekspor konten dokumen Google Workspace pada versi sebelumnya di browser
Untuk mengekspor konten dokumen Google Workspace pada versi sebelumnya dalam browser, gunakan metode revisions.get
dengan ID file yang akan didownload dan ID revisi. Jika pengguna memiliki
akses download ke file, link untuk mendownload file dan isinya
akan ditampilkan. Anda dapat mengalihkan pengguna ke URL ini, atau menawarkannya sebagai link yang dapat diklik.