Tạo và quản lý tệp

Hướng dẫn này giải thích cách tạo và quản lý tệp trong Google Drive.

Tạo tệp

Để tạo một tệp trong Drive không chứa siêu dữ liệu hoặc nội dung, hãy sử dụng phương thức files.create() mà không có tham số nào. Tệp được cấp kind của drive.file, id, name của "Untitled" (Chưa có tên) và mimeType của application/octet-stream. uploadType được đánh dấu là bắt buộc nhưng mặc định là media, vì vậy, bạn không thực sự phải cung cấp giá trị này.

Để biết thêm thông tin về giới hạn tệp trên Drive, hãy xem phần Giới hạn tệp và thư mục.

Tạo tệp chỉ chứa siêu dữ liệu

Tệp chỉ chứa siêu dữ liệu không chứa nội dung. Siêu dữ liệu là dữ liệu (chẳng hạn như name, mimeType và createdTime) mô tả tệp. Các trường như name không phụ thuộc vào người dùng và hiển thị giống nhau cho mỗi người dùng, trong khi các trường như viewedByMeTime chứa các giá trị dành riêng cho người dùng.

Một ví dụ về tệp chỉ chứa siêu dữ liệu là thư mục có loại MIME là application/vnd.google-apps.folder. Để biết thêm thông tin, hãy xem phần Tạo và điền sẵn thư mục. Một ví dụ khác là lối tắt trỏ đến một tệp khác trên Drive có loại MIME là application/vnd.google-apps.shortcut. Để biết thêm thông tin, hãy xem bài viết Tạo lối tắt đến một tệp trên Drive.

Quản lý hình thu nhỏ

Hình thu nhỏ giúp người dùng xác định các tệp trên Drive. Drive có thể tự động tạo hình thu nhỏ cho các loại tệp phổ biến hoặc bạn có thể cung cấp hình thu nhỏ do ứng dụng của bạn tạo. Để biết thêm thông tin, hãy xem phần Tải hình thu nhỏ lên.

Sao chép tệp hiện có

Để sao chép tệp và áp dụng mọi bản cập nhật được yêu cầu, hãy sử dụng phương thức files.copy(). Để tìm fileId cần sao chép, hãy sử dụng phương thức files.list().

Xin lưu ý rằng bạn cần sử dụng phạm vi API Drive thích hợp để uỷ quyền cho lệnh gọi. Để biết thêm thông tin về phạm vi Drive, hãy xem bài viết Chọn phạm vi API Google Drive.

Giới hạn và điều cần cân nhắc

Khi chuẩn bị sao chép tệp, hãy lưu ý những giới hạn và điều cần cân nhắc sau:

  • Quyền:

    • Quy tắc hạn chế tệp copyRequiresWriterPermission xác định người có thể sao chép tệp. Để biết thêm thông tin, hãy xem phần Ngăn người dùng tải xuống, in hoặc sao chép tệp.
    • Trường capabilities/canCopy của tài nguyên files xác định xem người dùng có thể sao chép tệp hay không. Để biết thêm thông tin, hãy xem phần Tìm hiểu về các tính năng của tệp.
    • Người dùng đã tạo bản sao sẽ sở hữu tệp đã sao chép. Không có chế độ cài đặt chia sẻ nào khác từ tệp nguồn được sao chép. Nếu bản sao được tạo trong một thư mục dùng chung, thì bản sao đó sẽ kế thừa các quyền của thư mục đó.
    • Quyền sở hữu của tệp được sao chép có thể thay đổi và bản sao có thể không kế thừa chế độ cài đặt chia sẻ của tệp gốc. Bạn có thể cần đặt lại các chế độ cài đặt này.

  • Quản lý tệp:

    • Một số tệp, chẳng hạn như lối tắt của bên thứ ba, không bao giờ sao chép được.
    • Bạn chỉ có thể sao chép một tệp vào một thư mục mẹ. Không hỗ trợ việc chỉ định nhiều thành phần mẹ. Nếu không chỉ định trường parents, tệp sẽ kế thừa mọi phần tử mẹ có thể phát hiện được từ tệp nguồn.
    • Mặc dù thư mục là một loại tệp, nhưng bạn không thể sao chép thư mục. Thay vào đó, hãy tạo một thư mục đích và đặt trường parents của các tệp hiện có thành thư mục đích. Sau đó, bạn có thể xoá thư mục nguồn ban đầu.
    • Trừ phi bạn chỉ định tên tệp mới, phương thức files.copy() sẽ tạo một tệp có cùng tên với tệp gốc.
    • Việc sử dụng files.copy() quá mức có thể dẫn đến việc vượt quá hạn mức API Drive. Để biết thêm thông tin, hãy xem phần Giới hạn sử dụng.

Sau đây là một số bước tiếp theo mà bạn có thể thử: