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

Tài nguyên tệp

Các trường sau trong tài nguyên File chỉ được điền sẵn cho các 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 này hay không.
  • capabilities/canAddFolderFromAnotherDrive: Liệu người dùng hiện tại có thể thêm một thư mục từ một ổ khác (một ổ dùng chung khác hoặc Ổ 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á thư mục 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 thư mục con của thư mục này ra khỏ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 thư mục 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 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 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 thư mục con của thư mục này vào thùng rác hay không.
  • driveId: Mã nhận dạng của ổ đĩa dùng chung chứa tệp.
  • trashingUser: Nếu tệp đã bị 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 mục được chuyển vào thùng rác. Nếu bạn đang sử dụng API Drive phiên bản cũ v2, thì trường này được gọi là trashedDate.

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

  • permissions: Do kích thước tiềm năng của ACL 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ợ phân trang để liệt kê các quyền cho một tệp trong bộ nhớ dùng chung hoặc thư mục bộ nhớ dùng chung.
  • owners, ownerNames, ownedByMe: Các tệp trong một ổ đĩa dùng chung thuộc sở hữu của ổ đĩa dùng chung, chứ không phải của từng người dùng.
  • folderColorRgb: Không thể tô màu riêng lẻ cho các thư mục.
  • shared: Tất cả các mục trong một bộ nhớ dùng chung đều được chia sẻ.
  • writersCanShare: Không thể hạn chế việc chia sẻ theo vai trò trong các ổ đĩa 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ác trường đó với các ổ đĩa dùng chung:

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

  • parents: Thư mục mẹ sẽ không xuất hiện trong danh sách thư mục 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 thư mục mẹ. Ngoài thư mục cấp cao nhất, danh sách thư mục mẹ phải chứa đúng một mục nếu tệp nằm trong một bộ nhớ dùng chung.

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

Tài nguyên quyền

Trường permissionDetails trong tài nguyên Permission chỉ được điền sẵ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 rút gọn đang có hoặc được kế thừa bởi tệp bộ nhớ dùng chung này. Trường này là trường chỉ có đầu ra và chỉ xuất hiện đối với 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.
  • Phương thức permissions.list() hỗ trợ phân trang.

Thay đổi tài nguyên

Các trường mới sau đây có trong tài nguyên Change cho 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ã nhận dạng 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ập nhật của ổ dùng chung. Hiện 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ể bạn cần thực hiện thêm các thay đổi đối với các ứng dụng cần đồng bộ hoá nội dung với ổ đĩa dùng chung hoặc theo dõi hoạt động. Để biết thông tin chi tiết, hãy xem phần theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.