Google Drive API mendukung beberapa jenis tindakan download dan ekspor, seperti yang tercantum dalam tabel berikut:
Download konten |
|
|||
Ekspor |
|
Bagian lainnya dalam panduan ini memberikan petunjuk terperinci untuk melakukan jenis tindakan download dan ekspor ini.
Mendownload konten file blob
Untuk mendownload file blob yang disimpan di Drive, gunakan metode files.get
dengan ID file untuk didownload dan parameter URL alt=media
. Parameter URL alt=media
memberi tahu
server bahwa download konten sedang 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 diotorisasi 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, yang memungkinkan pengguna
melihat dan mengelola semua file Drive Anda. Untuk mempelajari cakupan Drive lebih lanjut, baca informasi autentikasi dan otorisasi khusus API.
Pengguna dengan izin edit dapat membatasi download menurut pengguna hanya baca melalui
menyetel kolom
copyRequiresWriterPermission
ke false
.
File yang diidentifikasi sebagai
penyalahgunaan
(seperti software berbahaya) hanya dapat didownload oleh pemilik file.
Selain itu, parameter kueri get
acknowledgeAbuse=true
harus disertakan
untuk menunjukkan bahwa pengguna telah menyadari risiko mendownload software
yang berpotensi tidak diinginkan atau file penyalahgunaan lainnya. Aplikasi Anda harus memperingatkan pengguna secara interaktif sebelum menggunakan parameter kueri ini.
Download sebagian
Download sebagian hanya mencakup mendownload sebagian file. Anda
dapat menentukan bagian file yang ingin didownload menggunakan
rentang byte
dengan header Range
. Contoh:
Range: bytes=500-999
Mendownload konten file blob di versi sebelumnya
Untuk mendownload konten file blob di versi sebelumnya, gunakan metode revisions.get
dengan ID file untuk 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 tersebut dan kontennya 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 untuk 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, baca
informasi otorisasi dan autentikasi khusus
API.
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 dokumennya, link untuk mendownload file tersebut dan kontennya 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 versi sebelumnya di browser
Untuk mengekspor konten dokumen Google Workspace pada versi sebelumnya dalam
browser, gunakan metode revisions.get
dengan ID file untuk didownload dan ID revisi. Jika pengguna memiliki
akses download ke file, link untuk mendownload file tersebut dan kontennya
akan ditampilkan. Anda dapat mengalihkan pengguna ke URL ini, atau menawarkannya sebagai link yang dapat diklik.