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 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.

Hướng dẫn này trình bày những điểm khác biệt về API dành riêng cho bộ nhớ dùng chung trong các tài nguyên files và changes.

Tài nguyên tệp

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

  • hasAugmentedPermissions: Cho biết liệu người dùng có được cấp quyền truy cập trực tiếp vào tệp này hay không.
  • capabilities/canAddFolderFromAnotherDrive: Cho biết liệu người dùng hiện tại có thể thêm một thư mục từ một ổ đĩa khác (một 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: Cho biết liệu người dùng hiện tại có thể xoá các thư mục con của thư mục này hay không.
  • capabilities/canMoveChildrenOutOfDrive: Cho biết liệu người dùng hiện tại có thể di chuyển các thư mục con của thư mục này ra bên ngoài bộ nhớ dùng chung hay không.
  • capabilities/canMoveChildrenWithinDrive: Cho biết liệu người dùng hiện tại có thể di chuyển các thư mục con của thư mục này trong bộ nhớ dùng chung hay không.
  • capabilities/canMoveItemWithinDrive: Cho biết 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: Cho biết liệu người dùng hiện tại có quyền đọc đối với bộ nhớ dùng chung mà tệp này thuộc về hay không.
  • capabilities/canTrashChildren: Cho biết 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ã của bộ nhớ dùng chung nơi tệp được lưu trữ.
  • trashingUser: Nếu tệp đã bị chuyển vào thùng rác một cách rõ ràng, thì đây là 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 v2 cũ hơn, 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 danh sách kiểm soát truy cập (ACL) vào bộ nhớ dùng chung, nên quyền không được trả về như 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 đối với 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 bộ nhớ dùng chung thuộc sở hữu của bộ nhớ 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 cho từng thư mục.
  • shared: Tất cả các mục trong bộ nhớ dùng chung đều được chia sẻ.
  • writersCanShare: 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 đối với một mục:

  • sharedWithMeDate
  • sharingUser

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

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

  • parents: Thư mục mẹ 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 ra, ngoại trừ thư mục cấp cao nhất, danh sách thư mục 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 thay đổi

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

  • changeType: Loại thay đổi. Các giá trị có thể 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 cập nhật của bộ nhớ dùng chung. Xuất 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ể cần thực hiện các thay đổi bổ sung đối với những ứ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 xem Theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.