Chèn một tệp mới.
Phương thức này hỗ trợ URI /upload và chấp nhận nội dung nghe nhìn đã 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:
*/*
Lưu ý: Hãy chỉ định loại MIME hợp lệ, thay vì giá trị */* cố định. Giá trị cố định */* chỉ dùng để cho biết rằng bạn có thể tải mọi loại MIME hợp lệ lên.
Để 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 files.insert 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 title khi chèn tệp bằng API. Ví dụ: thao tác chèn tệp JPEG phải chỉ định nội dung tương tự như "title": "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ó thể đọc được điền bằng phần mở rộng được chỉ định ban đầu trong thuộc tính title. Khi người dùng Google Drive yêu cầu tải 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 tệp) dựa trên tiêu đề. Trong trường hợp thiếu tiện ích, Drive sẽ cố gắng xác định tiện ích dựa trên loại MIME của tệp.
Yêu cầu HTTP
- URI tải lên, đối với các yêu cầu tải nội dung nghe nhìn lên:
POST https://www.googleapis.com/upload/drive/v2/files - URI siêu dữ liệu, đối với các yêu cầu chỉ siêu dữ liệu:
POST https://www.googleapis.com/drive/v2/files
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Các tham số | |
|---|---|
uploadType |
Loại yêu cầu tải lên URI Các giá trị được chấp nhận là:
|
convert |
Liệu có chuyển đổi tệp này sang định dạng Trình chỉnh sửa tài liệu tương ứng hay không. |
enforceSingleParent |
Ngừng sử dụng: Tính năng tạo tệp trong nhiều thư mục không còn được hỗ trợ nữa. |
ocr |
Liệu bạn có thử nhận dạng ký tự quang học (OCR) trên các tệp tải lên ở định dạng .jpg, .png, .gif hoặc .pdf hay không. |
ocrLanguage |
Nếu ocr là đúng, hãy gợi ý ngôn ngữ sử dụng. Giá trị hợp lệ là mã BCP 47. |
pinned |
Liệu có ghim bản sửa đổi tiêu đề của tệp đã tải lên không. Một tệp có thể có tối đa 200 bản sửa đổi được ghim. |
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 dùng |
timedTextLanguage |
Ngôn ngữ của văn bản có dấu thời gian. |
timedTextTrackName |
Tên bản nhạc văn bản có dấu thời gian. |
useContentAsIndexableText |
Liệu có sử dụng nội dung dưới dạng văn bản có thể lập chỉ mục hay không. |
visibility |
Chế độ hiển thị của tệp mới. Tham số này chỉ có liên quan khi conversion=false. |
includePermissionsForView |
Chỉ định quyền của khung hiển thị bổ sung để đưa vào phản hồi. Chỉ hỗ trợ giá trị |
includeLabels |
Danh sách mã nhãn được phân tách bằng dấu phẩy để đư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/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.file
Một số phạm vi bị hạn chế và cần phải được đánh giá bảo mật thì ứng dụng của bạn mới có thể sử dụng những phạm vi đó. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.