- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
Cập nhật siêu dữ liệu, nội dung hoặc cả hai của một tệp.
Khi gọi phương thức này, bạn chỉ cần điền các trường trong yêu cầu mà bạn muốn sửa đổi. Khi bạn cập nhật các trường, một số trường có thể tự động thay đổi, chẳng hạn như modifiedDate. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
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 phần 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.
Yêu cầu HTTP
- URI tải lên, cho các yêu cầu tải nội dung nghe nhìn lên:
PUT https://www.googleapis.com/upload/drive/v2/files/{fileId} - URI siêu dữ liệu, cho các yêu cầu chỉ có siêu dữ liệu:
PUT https://www.googleapis.com/drive/v2/files/{fileId}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số | |
|---|---|
fileId |
Mã của tệp cần cập nhật. |
Tham số truy vấn
| Thông số | |
|---|---|
addParents |
Danh sách mã nhận dạng cấp trên được phân tách bằng dấu phẩy mà bạn muốn thêm. |
convert |
Không dùng nữa: Tham số này không có chức năng. |
enforceSingleParent |
Không dùng nữa: Tính năng thêm tệp vào nhiều thư mục không còn được hỗ trợ. Thay vào đó, hãy sử dụng |
modifiedDateBehavior |
Xác định hành vi mà |
newRevision |
Liệu việc tải blob lên có nên tạo một bản sửa đổi mới hay không. Nếu là false, dữ liệu blob trong bản sửa đổi đầu hiện tại sẽ được thay thế. Nếu bạn đặt thành true hoặc không đặt, một blob mới sẽ được tạo dưới dạng bản sửa đổi đầu và các bản sửa đổi chưa được ghim trước đó sẽ được giữ lại trong một khoảng thời gian ngắn. Các phiên bản được ghim sẽ được lưu trữ vô thời hạn, sử dụng thêm hạn mức bộ nhớ, tối đa 200 phiên bản. Để biết thông tin chi tiết về cách lưu giữ các bản sửa đổi, hãy xem Trung tâm trợ giúp của Drive. |
ocr |
Có nên thử nhận dạng ký tự quang học (OCR) trên tệp tải lên ở định dạng .jpg, .png, .gif hoặc .pdf 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 mới hay không. Một tệp có thể có tối đa 200 phiên bản được ghim. |
removeParents |
Danh sách mã nhận dạng cấp trên được phân tách bằng dấu phẩy mà bạn muốn xoá. |
setModifiedDate |
Có đặt ngày sửa đổi bằng giá trị được cung cấp trong phần nội dung yêu cầu hay không. Việc đặt trường này thành |
supportsAllDrives |
Ứ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ụ đề. |
updateViewedDate |
Có cập nhật ngày xem sau khi cập nhật tệp thành công hay không. |
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. |
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ủa các nhãn được phân tách bằng dấu phẩy 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.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.scripts
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.