Tạo một tệp. Để biết thêm thông tin, hãy xem bài viết Tạo và quản lý tệp.
Phương thức này hỗ trợ URI /upload và chấp nhận nội dung đa phương tiện được tải lên có các đặc điểm sau:
- Kích thước tệp tối đa: 5.120 GB
- Các loại MIME nội dung đa phương tiện được chấp nhận:
*/*(Chỉ định một loại MIME hợp lệ, thay vì giá trị
*/*theo nghĩa đen. Giá trị cố định*/*chỉ được dùng để cho biết rằng bạn có thể tải lên mọi loại MIME hợp lệ. Để biết thêm thông tin, hãy xem Các loại MIME được Google Workspace và Google Drive hỗ trợ.)
Để biết thêm thông tin về cách tải tệp lên, hãy xem phần Tải dữ liệu tệp lên.
Các ứng dụng tạo lối tắt bằng phương thức create phải chỉ định loại MIME application/vnd.google-apps.shortcut.
Ứng dụng phải chỉ định một đuôi tệp trong thuộc tính name khi chèn tệp bằng API. Ví dụ: thao tác chèn một tệp JPEG phải chỉ định nội dung như "name": "cat.jpg" trong siêu dữ liệu.
Các yêu cầu GET tiếp theo bao gồm thuộc tính fileExtension chỉ đọc được điền sẵn bằng tiện ích được chỉ định ban đầu trong thuộc tính name. Khi người dùng Google Drive yêu cầu tải một tệp xuống hoặc khi tệp được tải xuống thông qua ứng dụng đồng bộ hoá, Drive sẽ tạo một tên tệp đầy đủ (có đuôi) dựa trên tên. Trong trường hợp thiếu phần mở rộng, Drive sẽ cố gắng xác định phần mở rộng dựa trên loại MIME của tệp.
Yêu cầu HTTP
- URI tải lên, cho các yêu cầu tải nội dung đa phương tiện lên:
POST https://www.googleapis.com/upload/drive/v3/files - URI siêu dữ liệu, cho các yêu cầu chỉ có siêu dữ liệu:
POST https://www.googleapis.com/drive/v3/files
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Thông số | |
|---|---|
enforceSingleParent |
Không dùng nữa: Tính năng tạo tệp trong nhiều thư mục không còn được hỗ trợ. |
ignoreDefaultVisibility |
Có bỏ qua chế độ cài đặt mặc định về chế độ hiển thị của miền đối với tệp đã tạo hay không. Theo mặc định, quản trị viên miền có thể chọn hiển thị tất cả các tệp đã tải lên cho miền; tham số này bỏ qua hành vi đó cho yêu cầu. Các quyền vẫn được kế thừa từ thư mục mẹ. |
keepRevisionForever |
Có đặt trường |
ocrLanguage |
Gợi ý về ngôn ngữ để xử lý OCR trong quá trình nhập hình ảnh (mã ISO 639-1). |
supportsAllDrives |
Liệu ứng dụng yêu cầu có hỗ trợ cả Drive của tôi và bộ nhớ dùng chung hay không. |
supportsTeamDrives |
Không dùng nữa: Thay vào đó, hãy sử dụng |
uploadType |
Loại yêu cầu tải lên đến URI Các giá trị được chấp nhận là:
|
useContentAsIndexableText |
Có sử dụng nội dung đã tải lên làm văn bản có thể lập chỉ mục hay không. |
includePermissionsForView |
Chỉ định những quyền xem bổ sung cần đưa vào phản hồi. Chỉ hỗ trợ |
includeLabels |
Danh sách mã nhận dạng được phân tách bằng dấu phẩy của các nhãn cần đưa vào phần |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của File.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của File.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.file
Một số phạm vi bị hạn chế và yêu cầu bạn phải đánh giá bảo mật để ứng dụng của bạn có thể sử dụng các phạm vi đó. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.