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 bằng Google Drive API.

Tạo tệp

Để tạo một tệp không chứa siêu dữ liệu hoặc nội dung trong Drive, hãy sử dụng phương thức files.create mà không có tham số. Tệp được đặt kind là drive.file, id, name là "Chưa có tiêu đề" và mimeType là 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 về tệp và thư mục.

Tạo tệp chỉ có siêu dữ liệu

Tệp chỉ chứa siêu dữ liệu không có 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à xuất hiện giống nhau đối với 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ỉ có siêu dữ liệu là thư mục có loại MIME 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ông tin vào 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 một tệp hiện có

Để sao chép một tệp và áp dụng mọi nội dung 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 một phạm vi Drive API thích hợp để uỷ quyền cho lệnh gọi. Để biết thêm thông tin về các phạm vi của Drive, hãy xem bài viết Chọn phạm vi của API Google Drive.

Giới hạn và điểm 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ểm cần cân nhắc sau:

  • Quyền:

    • Đối tượng DownloadRestrictionsMetadata của tài nguyên files xác định những 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.
    • Tài nguyên trường capabilities.canCopy 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 bài viết Tìm hiểu 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 được sao chép. Không có chế độ cài đặt chia sẻ nào khác của 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 phải đặt lại các chế độ cài đặt này.

  • Quản lý tệp:

    • Bạn không thể sao chép một số tệp, chẳng hạn như lối tắt của bên thứ ba.
    • 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 phần tử mẹ. Nếu bạn không chỉ định trường parents, thì tệp sẽ kế thừa mọi thư mục 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 ra một tệp có cùng tên với tệp gốc.
    • Việc sử dụng quá nhiều files.copy 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 bài viết Hạn mức sử dụng.

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