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
menggunakan kolom capabilities.canDownload
pada
Referensi files
.
Bagian selanjutnya dari panduan ini memberikan petunjuk terperinci untuk menjalankan jenis-jenis tersebut tindakan download dan ekspor.
Mendownload 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 di mana download konten diminta sebagai respons alternatif
format font.
Parameter URL alt=media
adalah sistem
parameter
yang tersedia di semua Google REST API. Jika Anda 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
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 harus diizinkan dengan cakupan yang memungkinkan
akses baca ke isi file. Misalnya, sebuah aplikasi yang menggunakan
drive.readonly.metadata
cakupan tidak diizinkan untuk mendownload konten file.
Contoh kode ini menggunakan cakupan file “drive” yang dibatasi yang memungkinkan pengguna untuk
melihat dan mengelola semua file Drive Anda. Untuk mempelajari lebih lanjut tentang
Cakupan Drive, lihat Memilih Google Drive API
cakupan kami.
Pengguna dengan izin edit dapat membatasi
pengunduhan oleh pengguna hanya baca melalui
menyetel copyRequiresWriterPermission
ke false
.
File yang diidentifikasi sebagai
melecehkan
(seperti software berbahaya) hanya dapat didownload oleh pemilik file.
Selain itu, parameter kueri get
, acknowledgeAbuse=true
, harus disertakan
untuk menunjukkan bahwa pengguna telah mengetahui risiko mendownload
perangkat lunak yang tidak diinginkan
atau file penyalahgunaan lainnya. Aplikasi Anda harus secara interaktif
memperingatkan pengguna sebelum menggunakan parameter kueri ini.
Download sebagian
Download sebagian adalah mengunduh hanya sebagian file yang telah ditentukan. Anda
dapat menentukan bagian dari file yang ingin
Anda unduh dengan menggunakan byte
rentang
dengan header Range
. Contoh:
Range: bytes=500-999
Download konten file blob di versi sebelumnya
Untuk mendownload konten file blob di 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 konten yang didownload
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 download
revisi, lihat Mendownload dan memublikasikan file
revisi.
Mendownload konten file blob di browser
Untuk mendownload konten file blob yang disimpan di Drive dalam
browser, alih-alih melalui API, gunakan
Kolom webContentLink
halaman
Resource files
. Jika pengguna telah mendownload
akses ke file, tautan untuk mengunduh
file dan isinya
dikembalikan. Anda dapat mengalihkan pengguna ke URL ini, atau menawarkannya sebagai
tautan.
Ekspor 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. Diekspor
konten dibatasi hingga 10 MB.
Contoh kode berikut menunjukkan cara menggunakan metode files.export
untuk mengekspor
Dokumen Google Workspace dalam format PDF menggunakan klien Drive API
{i>library<i}:
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 lebih lanjut tentang
Cakupan Drive, lihat Memilih Google Drive API
cakupan kami.
Contoh kode ini juga mendeklarasikan jenis MIME ekspor sebagai application/pdf
. Untuk
daftar lengkap semua jenis MIME ekspor yang didukung untuk setiap Google Workspace
dokumen, lihat Mengekspor jenis MIME untuk Google Workspace
dokumen.
Mengekspor konten dokumen Google Workspace di browser
Untuk mengekspor konten dokumen Google Workspace dalam browser, gunakan
Kolom exportLinks
halaman
Resource files
. Bergantung pada dokumennya
, sebuah tautan untuk mengunduh file dan isinya ditampilkan untuk setiap 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
diunduh dan ID revisi. Jika pengguna memiliki
akses unduh ke file, tautan untuk mengunduh file dan isinya
dikembalikan. Anda dapat mengalihkan pengguna ke URL ini, atau menawarkannya sebagai
tautan.