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ác mô hình tổ chức, chia sẻ và quyền sở hữu khác nhau trên Drive của tôi. Do đó, một số thao tác trong Drive của tôi không được phép chứa nội dung trong bộ nhớ dùng chung. Tài liệu này trình bày các điểm khác biệt về API dành riêng cho bộ nhớ dùng chung.

Tài nguyên Files

Các trường sau đây chỉ được điền sẵn cho 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 ngay trên tệp này hay không.
  • capabilities/canAddFolderFromAnotherDrive – Người dùng hiện tại có thể thêm thư mục từ một bộ nhớ dùng chung khác (bộ nhớ dùng chung khác hoặc Drive của tôi) vào thư mục này hay không.
  • capabilities/canDeleteChildren – Liệu người dùng hiện tại có thể xoá phần tử con của thư mục này hay không.
  • capabilities/canMoveChildrenOutOfDrive – Liệu người dùng hiện tại có thể di chuyển phần tử con của thư mục này ra ngoài bộ nhớ dùng chung hay không.
  • capabilities/canMoveChildrenWithinDrive – Liệu người dùng hiện tại có thể di chuyển phần tử con của thư mục này trong bộ nhớ dùng chung hay không.
  • 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 hay không.
  • capabilities/canReadDrive – Liệu người dùng hiện tại có quyền đọc vào bộ nhớ dùng chung có chứa tệp này hay không.
  • capabilities/canTrashChildren – Liệu người dùng hiện tại có thể chuyển các phần tử con của thư mục này vào thùng rác hay không.
  • driveId – Mã của bộ nhớ dùng chung chứa tệp.
  • trashingUser – Nếu tệp đã được chuyển vào thùng rác một cách rõ ràng, thì người dùng đã chuyển tệp vào thùng rác.

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

Các trường sau đây không được điền sẵn 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, các quyền sẽ không được trả về dưới dạng 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 chính bộ nhớ dùng chung đó.
  • owners, ownerNames, ownedByMe — Các tệp trong bộ nhớ dùng chung thuộc sở hữu của bộ nhớ dùng chung chứ không phải người dùng cá nhân.
  • folderColorRgb — Bạn không thể tô màu riêng các thư mục
  • shared — Mọi mục trong bộ nhớ dùng chung đều được chia sẻ.
  • writersCanShare – Hiện tại, bạn không thể hạn chế việc chia sẻ theo vai trò trong bộ nhớ dùng chung.

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

  • sharedWithMeDate
  • sharingUser

Bạn cần đặc biệt cân nhắc các 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 với thư mục gốc Drive của tôi; trường này không đúng đối với thư mục cấp cao nhất của bộ nhớ dùng chung.

  • parents – Phần tử mẹ không xuất hiện trong danh sách phần tử 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 vào phần tử mẹ. Ngoài ra, ngoại trừ thư mục cấp cao nhất, danh sách gốc phải chứa đúng 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 sẵn cho các tệp nằm trong một bộ nhớ dùng chung. Trường này là danh sách các Quyền thu gọn được bật hoặc kế thừa bởi tệp bộ nhớ dùng chung này. Trường này là trường chỉ có dữ liệu đầu ra và chỉ hiển thị cho các mục trong bộ nhớ dùng chung. Ngoài ra,

  • hai vai trò mới của 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

Các trường mới sau đây có sẵn trong tài nguyên Changes cho một bộ nhớ dùng chung:

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

Bạn có thể cần phải thay đổi thêm đối với các ứng dụng cần đồng bộ hoá nội dung với 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 bài viết theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.