Method: files.update

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 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 đa phương tiện lên:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI siêu dữ liệu, cho các yêu cầu chỉ có siêu dữ liệu:
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
fileId

string

Mã nhận dạng của tệp.

Tham số truy vấn

Thông số
addParents

string

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.
enforceSingleParent
(deprecated)

boolean

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 phím tắt.
keepRevisionForever

boolean

Có đặt trường keepForever trong bản sửa đổi tiêu đề mới hay không. Điều này chỉ áp dụng cho các tệp có nội dung 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

string

Gợi ý về ngôn ngữ để xử lý OCR trong quá trình nhập hình ảnh (mã ISO 639-1).
removeParents

string

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á.
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 sử dụng supportsAllDrives.
uploadType

string

Loại yêu cầu tải lên đến URI /upload. Nếu bạn đang tải dữ liệu lên bằng URI /upload, thì bạn phải điền trường này. Nếu bạn đang tạo một tệp chỉ có siêu dữ liệu, thì bạn không bắt buộc phải điền trường này. Ngoài ra, trường này không xuất hiện 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 có siêu dữ liệu.
  • multipart – Tải nhiều phần lê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 nối. Tải tệp lên theo cách có thể tiếp tục, bằng cách sử dụng một loạt ít nhất hai yêu cầu, trong đó yêu cầu đầu tiên bao gồm siêu dữ liệu.
useContentAsIndexableText

boolean

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

string

Chỉ định những quyền xem bổ sung cần đưa vào phản hồi. Chỉ hỗ trợ published.
includeLabels

string

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 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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à 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.