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 đ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:
*/*
Lưu ý: Chỉ định một loại MIME hợp lệ, thay vì giá trị */* cố định. Giá trị cố định */* chỉ được dùng để cho biết rằng bạn có thể tải lên bất kỳ loại MIME hợp lệ nào.
Để 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 đ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 một giá trị 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 sẵn phần mở rộng ban đầu được chỉ định trong thuộc tính title. 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 tên tệp đầy đủ (có đuôi) dựa trên tiêu đề. Trong trường hợp thiếu đuôi tệp, Drive sẽ cố gắng xác định đuôi tệp dựa trên loại MIME của tệp.
Yêu cầu HTTP
- URI tải lên, dành cho 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, dành cho 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
| Thông số | |
|---|---|
convert |
Liệu có chuyển đổi tệp này sang định dạng tương ứng của Trình chỉnh sửa Tài liệu 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 có nên thử OCR trên tệp .jpg, .png, .gif hoặc .pdf được tải lên hay không. |
ocrLanguage |
Nếu ocr là đúng (true), hãy gợi ý ngôn ngữ cần sử dụng. Các giá trị hợp lệ là mã BCP 47. |
pinned |
Liệu có ghim bản sửa đổi đầu tiên của tệp đã tải lên hay 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: Hãy sử dụng |
timedTextLanguage |
Ngôn ngữ của văn bản có thời gian. |
timedTextTrackName |
Tên của bản nhạc có văn bản được căn chỉnh theo thời gian. |
uploadType |
Loại yêu cầu tải lên URI Các giá trị được chấp nhận là:
|
useContentAsIndexableText |
Liệu có nên 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 convert=false. |
includePermissionsForView |
Chỉ định quyền của thành phần hiển thị bổ sung cần đưa vào phản hồi. Chỉ hỗ trợ |
includeLabels |
Danh sách mã nhận dạng của các 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à yêu cầu đánh giá bảo mật để ứng dụng của bạn có thể sử dụng. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.