API Google Drive hỗ trợ một số loại thao tác tải xuống và xuất, chẳng hạn như được liệt kê trong bảng sau:
Tải video xuống |
|
|||
Xuất dữ liệu |
|
Trước khi bạn tải xuống hoặc xuất nội dung tệp, hãy xác minh rằng người dùng có thể tải
bằng cách sử dụng trường capabilities.canDownload
trên
Tài nguyên files
.
Phần còn lại của hướng dẫn này cung cấp hướng dẫn chi tiết về cách thực hiện các loại nội dung này hành động tải xuống và xuất.
Tải nội dung tệp blob xuống
Để tải tệp blob lưu trữ trên Drive xuống, hãy sử dụng phương thức files.get
kèm theo mã nhận dạng của tệp cần tải xuống
và tham số URL alt=media
. Tham số URL alt=media
cho biết
máy chủ yêu cầu tải nội dung xuống làm phản hồi thay thế
.
Tham số URL alt=media
là một hệ thống
tham số
có sẵn trên tất cả các API REST của Google. Nếu bạn sử dụng thư viện ứng dụng cho
API Drive, bạn không cần phải đặt tham số này một cách rõ ràng.
Mã mẫu sau đây cho biết cách sử dụng phương thức files.get
để tải một tệp
bằng thư viện ứng dụng API Drive.
Java
Python
Node.js
PHP
.NET
Mã mẫu này sử dụng phương thức thư viện có thêm tham số URL alt=media
đến yêu cầu HTTP cơ bản.
Các tệp tải xuống bắt đầu từ ứng dụng của bạn phải được cấp phép với phạm vi cho phép
quyền đọc nội dung tệp. Ví dụ: một ứng dụng sử dụng
Phạm vi drive.readonly.metadata
không được phép tải nội dung tệp xuống.
Mã mẫu này sử dụng phạm vi tệp "drive" bị hạn chế cho phép người dùng
xem và quản lý tất cả các tệp của bạn trên Drive. Để tìm hiểu thêm về
Phạm vi Drive, tham khảo bài viết Chọn API Google Drive
các phạm vi.
Người dùng có quyền chỉnh sửa có thể hạn chế người dùng chỉ có quyền đọc thông qua việc tải xuống
thiết lập copyRequiresWriterPermission
sang false
.
Tệp được xác định là
lạm dụng
(chẳng hạn như phần mềm độc hại) chỉ chủ sở hữu tệp mới có thể tải xuống.
Ngoài ra, bạn phải thêm tham số truy vấn get
acknowledgeAbuse=true
để cho biết rằng người dùng đã xác nhận rủi ro về khả năng tải xuống
phần mềm không mong muốn hoặc các tệp lạm dụng khác. Ứng dụng của bạn nên có tính tương tác
hãy cảnh báo người dùng trước khi sử dụng tham số truy vấn này.
Tải xuống một phần
Tải xuống một phần chỉ bao gồm tải xuống một phần được chỉ định của tệp. Bạn
có thể chỉ định phần tệp bạn muốn tải xuống bằng cách sử dụng byte
phạm vi
với tiêu đề Range
. Ví dụ:
Range: bytes=500-999
Tải nội dung tệp blob ở phiên bản cũ xuống
Để tải xuống nội dung của các tệp blob ở phiên bản cũ hơn, hãy sử dụng
Phương thức revisions.get
có mã nhận dạng là
tệp cần tải xuống, mã bản sửa đổi và tham số URL alt=media
.
Tham số URL alt=media
cho máy chủ biết rằng một lượt tải nội dung xuống
được yêu cầu làm định dạng phản hồi thay thế. Tương tự như files.get
,
Phương thức revisions.get
cũng chấp nhận tham số truy vấn không bắt buộc
acknowledgeAbuse
và tiêu đề Range
. Để biết thêm thông tin về việc tải xuống
bản sửa đổi, hãy xem Tải tệp xuống và xuất bản
bản sửa đổi.
Tải nội dung tệp blob xuống trong trình duyệt
Để tải xuống nội dung của các tệp blob được lưu trữ trên Drive trong
trình duyệt, thay vì thông qua API, hãy sử dụng
Trường webContentLink
của
files
. Nếu người dùng đã tải xuống
truy cập vào tệp, liên kết để tải tệp xuống và nội dung của tệp là
bị trả lại. Bạn có thể chuyển hướng người dùng đến URL này hoặc cung cấp dưới dạng một URL có thể nhấp vào
.
Xuất nội dung tài liệu trên Google Workspace
Để xuất nội dung byte tài liệu trên Google Workspace, hãy sử dụng phương thức files.export
kèm theo mã nhận dạng của tệp cần xuất
và đúng loại MIME. Đã xuất
nội dung được giới hạn ở 10 MB.
Mã mẫu sau đây cho biết cách sử dụng phương thức files.export
để xuất một
Tài liệu trên Google Workspace ở định dạng PDF bằng ứng dụng Drive API
thư viện:
Java
Python
Node.js
PHP
.NET
Mã mẫu này sử dụng phạm vi drive
bị hạn chế để cho phép người dùng xem và
quản lý tất cả các tệp của bạn trên Drive. Để tìm hiểu thêm về
Phạm vi Drive, tham khảo bài viết Chọn API Google Drive
các phạm vi.
Mã mẫu này cũng khai báo loại MIME xuất là application/pdf
. Đối với
danh sách đầy đủ tất cả các loại MIME xuất được hỗ trợ cho mỗi Google Workspace
tài liệu này, hãy tham khảo bài viết Xuất các loại MIME cho Google Workspace
tài liệu.
Xuất nội dung tài liệu trên Google Workspace ra trình duyệt
Để xuất nội dung tài liệu trên Google Workspace trong một trình duyệt, hãy sử dụng
Trường exportLinks
của
files
. Tuỳ thuộc vào giấy tờ
loại, một liên kết để tải xuống tệp cùng với nội dung của tệp được trả về cho mỗi MIME
loại có sẵn. Bạn có thể chuyển hướng người dùng đến một URL hoặc cung cấp URL đó dưới dạng
đường liên kết có thể nhấp vào.
Xuất nội dung tài liệu trên Google Workspace ở phiên bản cũ trên trình duyệt
Để xuất nội dung tài liệu trên Google Workspace ở phiên bản cũ trong một
trình duyệt, hãy sử dụng phương thức revisions.get
có mã nhận dạng của tệp cần tải xuống và mã bản sửa đổi. Nếu người dùng có
quyền tải xuống tệp, liên kết để tải tệp xuống và nội dung của tệp là
bị trả lại. Bạn có thể chuyển hướng người dùng đến URL này hoặc cung cấp dưới dạng một URL có thể nhấp vào
.