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ị */* 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 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 nên 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 một tệp JPEG phải chỉ định nội dung nào đó 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 được điền sẵn bằng tiện ích được chỉ định ban đầu 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 một tên tệp đầy đủ (có đuôi) dựa trên tiêu đề. 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/v2/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/v2/files
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Thông số | |
|---|---|
convert |
Có chuyển đổi tệp này sang định dạng tương ứng của Bộ công cụ chỉnh sửa tài liệu của Google hay không. |
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ợ. |
ocr |
Có nên thử nhận dạng ký tự quang học (OCR) trên tệp .jpg, .png, .gif hoặc .pdf được tải lên hay không. |
ocrLanguage |
Nếu ocr là 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 |
Có ghim bản sửa đổi đầu của tệp đã tải lên hay không. Một tệp có thể có tối đa 200 phiên bản đượ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 sử dụng |
timedTextLanguage |
Ngôn ngữ của văn bản có dấu thời gian. |
timedTextTrackName |
Tên của tệp phụ đề. |
uploadType |
Loại yêu cầu tải lên đối với URI Các giá trị được chấp nhận là:
|
useContentAsIndexableText |
Có sử dụng nội dung làm 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. Quyền vẫn được kế thừa từ thư mục mẹ. Tham số này chỉ liên quan khi |
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 thực thể 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 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.