Tạo 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.create 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 name 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ư "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ó 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/v3/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/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 |
Liệu có bỏ qua chế độ cài đặt chế độ hiển thị mặc định của miền cho tệp đã tạo hay không. Theo mặc định, quản trị viên miền có thể chọn cho phép miền xem tất cả tệp đã tải lên; tham số này sẽ bỏ qua hành vi đó cho yêu cầu. Quyền vẫn được kế thừa từ thư mục mẹ. |
keepRevisionForever |
Liệu có đặt trường "keepForever" trong bản sửa đổi đầu mới hay không. Điều này chỉ áp dụng cho các tệp có nội dung tệp nhị phân trong Google Drive. Bạn chỉ có thể giữ vĩnh viễn 200 bản sửa đổi cho tệp. Nếu bạn đã đạt đến giới hạn, hãy thử xoá các bản sửa đổi được ghim. |
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: Hãy sử dụng |
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ó 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 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ợ trạng thái "đã xuất bản". |
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/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 đá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.