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