API Google Drive hỗ trợ một số loại thao tác tải xuống và xuất, như được liệt kê trong bảng sau:
Thao tác tải xuống |
|
||||
Xuất hành động |
|
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
.
Để biết nội dung mô tả về các loại tệp được đề cập ở đây, bao gồm cả tệp blob và tệp Google Workspace, hãy xem phần Loại tệp.
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 thao tác tải xuống và xuất này.
Tải nội dung tệp blob xuống
Để tải tệp blob được lưu trữ trên Drive xuống, hãy sử dụng phương thức files.get
với 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 một yêu cầu tải nội dung xuống đang được yêu cầu dưới dạng định dạng phản hồi thay thế.
Tham số URL alt=media
là một tham số hệ thống có sẵn 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, thì bạn không cần phải đặt thông 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 xuống bằng thư viện ứng dụng API Drive.
Java
Python
Node.js
PHP
.NET
Mã mẫu này sử dụng một 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 uỷ quyền 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ẫu mã 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 trên Drive của bạn. Để 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ế việc tải xuống của người dùng chỉ có thể đọc 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 gây hại) xuống.
Ngoài ra, tham số truy vấn get
acknowledgeAbuse=true
phải được đưa vào để cho biết người dùng đã xác nhận rủi ro tải xuống phần mềm có thể không mong muốn hoặc các tệp vi phạm khác. Ứng dụng của bạn nên thông báo tương tác cho người dùng trước khi sử dụng tham số truy vấn này.
Tải một phần xuống
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 phạm vi byte 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 nội dung của các tệp blob ở phiên bản cũ xuống, hãy sử dụng phương thức revisions.get
với mã nhận dạng 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 nội dung đang được yêu cầu tải xuống 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 các bản sửa đổi xuống, hãy xem phần Quản lý bản sửa đổi tệp.
Giao thức yêu cầu được hiển thị tại đây.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID
}/revisions/{REVISION_ID
}?alt=media
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 lưu trữ trên Drive trong một trình duyệt xuống, 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, hệ thống sẽ trả về một đường liên kết để tải tệp và nội dung của tệp xuống. Bạn có thể chuyển hướng người dùng đến URL này hoặc cung cấp URL này dưới dạng một liên kết có thể nhấp vào.
Tải nội dung tệp blob xuống trong các thao tác chạy trong thời gian dài
Để tải nội dung của tệp blob xuống trong các thao tác chạy trong thời gian dài, hãy sử dụng phương thức files.download
với mã nhận dạng của tệp cần tải xuống. Bạn có thể tuỳ ý đặt mã nhận dạng của bản sửa đổi. Đây là cách duy nhất để tải tệp Google Vids xuống. Để biết thêm thông tin, hãy xem phần Quản lý các thao tác chạy trong thời gian dài.
Xuất nội dung tài liệu trên Google Workspace
Để xuất nội dung byte của tài liệu Google Workspace, hãy sử dụng phương thức files.export
với mã nhận dạng của tệp cần xuất và loại MIME chính xác. Giới hạn kích thước của nội dung xuất ra là 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 Google Workspace ở định dạng PDF bằng cách sử dụng thư viện ứng dụng Drive API:
Java
Python
Node.js
PHP
.NET
Mẫu mã 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 trên Drive của bạn. Để 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
. Để biết danh sách đầy đủ tất cả các loại MIME xuất được hỗ trợ cho từng tài liệu Google Workspace, hãy tham khảo bài viết Xuất loại MIME cho tài liệu 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 Google Workspace trong 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 và nội dung của tệp xuống sẽ được trả về cho mọi loại MIME 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 một đường liên kết có thể nhấp vào.
Xuất nội dung tài liệu Google Workspace ở phiên bản cũ trong trình duyệt
Để xuất nội dung tài liệu trên Google Workspace ở phiên bản cũ trong
trình duyệt, hãy sử dụng phương thức revisions.get
với mã nhận dạng của tệp cần tải xuống và mã nhận dạng của bản sửa đổi để tạo
một đường liên kết xuất mà bạn có thể tải xuống từ đó. Nếu người dùng có quyền tải tệp xuống, hệ thống sẽ trả về một đường liên kết để tải tệp và nội dung của tệp xuống. 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 vào.
Xuất nội dung tài liệu trên Google Workspace trong các hoạt động lâu dài
Để xuất nội dung tài liệu Google Workspace trong các thao tác chạy trong thời gian dài, hãy sử dụng phương thức files.download
với mã nhận dạng của tệp cần tải xuống và mã nhận dạng của bản sửa đổi. Để biết thêm thông tin, hãy xem phần Quản lý các thao tác chạy trong thời gian dài.