Sự khác biệt giữa API Bộ nhớ dùng chung và API Drive của tôi

Bộ nhớ dùng chung tuân theo cách tổ chức, chia sẻ và quyền sở hữu khác nhau các mô hình khác nhau từ Drive của tôi. Do đó, một số thao tác trên Drive của tôi không được phép nội dung trong bộ nhớ dùng chung. Tài liệu này trình bày cụ thể về từng bộ nhớ dùng chung Sự khác biệt về API.

Tài nguyên Files

Các trường sau đây chỉ được điền sẵn cho những tệp nằm trong bộ nhớ dùng chung:

  • hasAugmentedPermissions – Liệu có người dùng nào được cấp quyền truy cập vào tệp hay không ngay trên tệp này.
  • capabilities/canAddFolderFromAnotherDrive — Liệu người dùng hiện tại có có thể thêm thư mục từ một bộ nhớ khác (bộ nhớ dùng chung khác hoặc Drive của tôi) vào thư mục này.
  • capabilities/canDeleteChildren — Liệu người dùng hiện tại có thể xoá hay không con của thư mục này.
  • capabilities/canMoveChildrenOutOfDrive — Liệu người dùng hiện tại có có thể di chuyển thư mục con của thư mục này ra ngoài bộ nhớ dùng chung.
  • capabilities/canMoveChildrenWithinDrive — Liệu người dùng hiện tại có có thể di chuyển thư mục con của thư mục này trong bộ nhớ dùng chung.
  • capabilities/canMoveItemWithinDrive — Liệu người dùng hiện tại có thể di chuyển mục trong bộ nhớ dùng chung này trong bộ nhớ dùng chung.
  • capabilities/canReadDrive — Người dùng hiện tại đã đọc hay chưa quyền truy cập vào bộ nhớ dùng chung chứa tệp này.
  • capabilities/canTrashChildren — Liệu người dùng hiện tại có thể chuyển vào thùng rác hay không con của thư mục này.
  • driveId – Mã bộ nhớ dùng chung chứa tệp vị trí.
  • trashingUser – Nếu tệp đã bị chuyển vào thùng rác một cách rõ ràng, người dùng đã chuyển vào thùng rác.

  • trashedTime — Thời gian chuyển mục vào thùng rác.

Những trường sau đây không được điền sẵn cho những tệp nằm trong bộ nhớ dùng chung:

  • permissions – Do kích thước tiềm năng của các tệp ACL của bộ nhớ dùng chung, nên các quyền không được trả lại như một phần của tệp. Sử dụng phương thức permissions.list, Hỗ trợ tính năng phân trang, để liệt kê các quyền cho một tệp trong bộ nhớ dùng chung hoặc bộ nhớ dùng chung.
  • owners, ownerNames, ownedByMe — Các tệp trong bộ nhớ dùng chung đang thuộc sở hữu của bộ nhớ dùng chung chứ không phải của người dùng cá nhân.
  • folderColorRgb — Bạn không thể tô màu từng thư mục
  • shared – Tất cả các mục trong bộ nhớ dùng chung đều được chia sẻ.
  • writersCanShare — Hiện không thể hạn chế chia sẻ theo trong bộ nhớ dùng chung.

Các trường sau đây chỉ được thiết lập khi người dùng đã được cấp quyền truy cập vào tệp các quyền đối với một mục:

  • sharedWithMeDate
  • sharingUser

Bạn cần đặc biệt cân nhắc những trường sau đây khi sử dụng cùng với bộ nhớ dùng chung:

  • parents.isRoot — Trường này chỉ đúng đối với thư mục gốc Drive của tôi; giá trị là false đối với thư mục cấp cao nhất của bộ nhớ dùng chung.

  • parents — Cha mẹ sẽ không xuất hiện trong danh sách cha mẹ nếu người dùng yêu cầu không phải là thành viên của bộ nhớ dùng chung và không có quyền truy cập cho phần tử mẹ. Ngoài ra, ngoại trừ thư mục cấp cao nhất, danh sách mẹ phải chứa chính xác một mục nếu tệp nằm trong bộ nhớ dùng chung.

  • capabilities/canRemoveChildren — Sử dụng capabilities/canDeleteChildren hoặc capabilities/canTrashChildren.

Tài nguyên Permissions

Trường permissionDetails chỉ được điền cho các tệp nằm trong bộ nhớ dùng chung. Trường này là danh sách các Quyền thu gọn đang bật hoặc được kế thừa bởi tệp trong bộ nhớ dùng chung này. Đây là trường chỉ đầu ra và chỉ áp dụng cho các mục trong bộ nhớ dùng chung. Ngoài ra,

  • hai vai trò mới là organizer và fileOrganizer đã được xác định.
  • permissions.list hiện hỗ trợ tính năng phân trang.

Tài nguyên Changes

Tài nguyên Changes có các trường mới sau đây để bộ nhớ dùng chung:

  • changeType — Loại thay đổi. Các giá trị có thể sử dụng là file và drive.
  • driveId – Mã của bộ nhớ dùng chung được liên kết với thay đổi này.
  • drive – Trạng thái mới của bộ nhớ dùng chung. Hiển thị nếu changeType là drive và người dùng vẫn là thành viên của bộ nhớ dùng chung.

Có thể có một số thay đổi khác cho những ứng dụng cần đồng bộ hoá nội dung có bộ nhớ dùng chung hoặc theo dõi hoạt động. Để biết thông tin chi tiết, hãy tham khảo theo dõi thay đổi cho người dùng và bộ nhớ dùng chung.