Trang này được dịch bởi Cloud Translation API.

Method: files.update

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 và/hoặc nội dung của tệp. Khi gọi phương thức này, chỉ điền các trường vào yêu cầu mà bạn muốn sửa đổi. Khi cập nhật các trường, một số trường có thể được tự động thay đổi, chẳng hạn như modifiedDate. Phương thức này hỗ trợ ngữ nghĩa bản vá.

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.

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:
PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
URI siêu dữ liệu, đối với các yêu cầu chỉ 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

Các tham số

uploadType

string

Loại yêu cầu tải lên URI /upload. Nếu bạn đang tải dữ liệu lên bằng URI /upload, thì trường này là bắt buộc. Nếu bạn đang tạo tệp chỉ có siêu dữ liệu, trường này là không bắt buộc. Ngoài ra, trường này không hiển thị trong tiện ích "Thử phương thức này" vì tiện ích này không hỗ trợ tải dữ liệu lên.

Các giá trị được chấp nhận là:

media – Tải lên đơn giản. Chỉ tải nội dung nghe nhìn lên mà không cung cấp siêu dữ liệu.
multipart – Tải lên nhiều phần. Tải cả nội dung nghe nhìn và siêu dữ liệu của nội dung đó lên trong một yêu cầu duy nhất.
resumable – Tải lên tiếp tục. Tải tệp lên theo cách tiếp nối, sử dụng một chuỗi gồm ít nhất hai yêu cầu, trong đó yêu cầu đầu tiên bao gồm siêu dữ liệu.

fileId

string

Mã của tệp cần cập nhật.

Tham số truy vấn

Các tham số
`uploadType`	`string` Loại yêu cầu tải lên URI `/upload`. Nếu bạn đang tải dữ liệu lên bằng URI `/upload`, thì trường này là bắt buộc. Nếu bạn đang tạo tệp chỉ có siêu dữ liệu, trường này là không bắt buộc. Ngoài ra, trường này không hiển thị trong tiện ích "Thử phương thức này" vì tiện ích này không hỗ trợ tải dữ liệu lên. Các giá trị được chấp nhận là: `media` – Tải lên đơn giản. Chỉ tải nội dung nghe nhìn lên mà không cung cấp siêu dữ liệu. `multipart` – Tải lên nhiều phần. Tải cả nội dung nghe nhìn và siêu dữ liệu của nội dung đó lên trong một yêu cầu duy nhất. `resumable` – Tải lên tiếp tục. Tải tệp lên theo cách tiếp nối, sử dụng một chuỗi gồm ít nhất hai yêu cầu, trong đó yêu cầu đầu tiên bao gồm siêu dữ liệu.
`addParents`	`string` Danh sách mã nhận dạng chính mà bạn muốn thêm được phân tách bằng dấu phẩy.
`convert (deprecated)`	`boolean` Ngừng sử dụng: Tham số này không có hàm.
`enforceSingleParent (deprecated)`	`boolean` Ngừng sử dụng: Chúng tôi không còn hỗ trợ thêm tệp vào nhiều thư mục. Thay vào đó, hãy sử dụng `shortcuts`.
`modifiedDateBehavior`	`enum (ModifiedDateBehavior)` Xác định hành vi mà `modifiedDate` được cập nhật. Thao tác này sẽ ghi đè `setModifiedDate`.
`newRevision`	`boolean` Liệu tệp tải lên bằng blob có nên tạo bản sửa đổi mới hay không. Nếu giá trị là sai, thì dữ liệu blob trong bản sửa đổi tiêu đề hiện tại sẽ được thay thế. Nếu bạn đặt chính sách này thành true hoặc không đặt, thì một blob mới sẽ được tạo dưới dạng bản sửa đổi phần đầu và các bản sửa đổi không được ghim trước đó sẽ được lưu giữ trong một khoảng thời gian ngắn. Các bản sửa đổi đã ghim được lưu trữ vô thời hạn, sử dụng hạn mức bộ nhớ bổ sung, tối đa 200 bản sửa đổi. Để 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`	`boolean` 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`	`string` 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`	`boolean` Liệu có ghim bản sửa đổi mới hay không. Một tệp có thể có tối đa 200 bản sửa đổi được ghim.
`removeParents`	`string` Danh sách được phân tách bằng dấu phẩy của các ID chính cần xóa.
`setModifiedDate`	`boolean` Liệu có đặt ngày sửa đổi bằng cách sử dụng giá trị được cung cấp trong nội dung yêu cầu hay không. Việc thiết lập trường này thành `true` sẽ tương đương với `modifiedDateBehavior=fromBodyOrNow` và `false` tương đương với `modifiedDateBehavior=now`. Để tránh có bất kỳ thay đổi nào đối với ngày sửa đổi, hãy đặt `modifiedDateBehavior=noChange`.
`supportsAllDrives`	`boolean` 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 (deprecated)`	`boolean` Không dùng nữa: Thay vào đó, hãy dùng `supportsAllDrives`.
`timedTextLanguage`	`string` Ngôn ngữ của văn bản có dấu thời gian.
`timedTextTrackName`	`string` Tên bản nhạc văn bản có dấu thời gian.
`updateViewedDate`	`boolean` Liệu có cập nhật ngày xem sau khi cập nhật tệp thành công hay không.
`useContentAsIndexableText`	`boolean` 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.
`includePermissionsForView`	`string` Chỉ định quyền của khung hiển thị bổ sung để đưa vào phản hồi. Chỉ hỗ trợ giá trị `published`.
`includeLabels`	`string` Danh sách mã nhãn được phân tách bằng dấu phẩy để đưa vào phần `labelInfo` của phản hồi.

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/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.scripts

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.