共享云端硬盘与 My Drive API 的差异

共享云端硬盘采用与“我的云端硬盘”不同的组织、共享和所有权模式。因此，您无法对共享云端硬盘中的内容执行某些“我的云端硬盘”操作。本文档简要介绍了共享云端硬盘特有的 API 差异。

Files 资源

以下字段仅会针对位于共享云端硬盘中的文件填充：

  • hasAugmentedPermissions - 是否向任何用户直接授予对此文件的文件访问权限。
  • capabilities/canAddFolderFromAnotherDrive - 当前用户是否可以将其他云端硬盘（其他共享云端硬盘或“我的云端硬盘”）中的文件夹添加到此文件夹。
  • capabilities/canDeleteChildren - 当前用户是否可以删除此文件夹的子文件夹。
  • capabilities/canMoveChildrenOutOfDrive - 当前用户是否可以将此文件夹的子文件夹移出共享云端硬盘。
  • capabilities/canMoveChildrenWithinDrive - 当前用户是否可以在共享云端硬盘中移动此文件夹的子文件夹。
  • capabilities/canMoveItemWithinDrive - 当前用户是否可以在共享云端硬盘中移动此共享云端硬盘项。
  • capabilities/canReadDrive - 当前用户是否拥有对该文件所属共享云端硬盘的读取权限。
  • capabilities/canTrashChildren - 当前用户是否可以将此文件夹的子文件夹移至回收站。
  • driveId - 文件所在的共享云端硬盘的 ID。
  • trashingUser - 如果文件已被明确移至回收站，则为将其移至回收站的用户。

  • trashedTime - 将内容放入回收站的时间。

系统不会为位于共享云端硬盘中的文件填充以下字段：

  • permissions - 由于共享云端硬盘 ACL 的潜在大小，系统不会将权限作为文件的一部分返回。您可以使用支持分页的 permissions.list 方法，列出共享云端硬盘中文件或共享云端硬盘本身的权限。
  • owners、ownerNames、ownedByMe - 共享云端硬盘中的文件归共享云端硬盘所有，而非个人用户。
  • folderColorRgb - 无法为文件夹单独设置颜色
  • shared - 共享云端硬盘中的所有内容均处于共享状态。
  • writersCanShare - 目前无法在共享云端硬盘中按角色限制共享。

只有当用户获得了对某项内容的文件访问权限后，系统才会设置以下字段：

  • sharedWithMeDate
  • sharingUser

在共享云端硬盘中使用以下字段时需要特别注意：

  • parents.isRoot - 此字段仅适用于“我的云端硬盘”根文件夹；对于共享云端硬盘顶级文件夹，此字段为 false。

  • parents - 如果请求访问的用户不是共享云端硬盘的成员，并且没有权限访问父级，则父级不会显示在父级列表中。此外，如果文件位于共享云端硬盘中，则父级列表（顶级文件夹除外）必须包含恰好一个项目。

  • capabilities/canRemoveChildren - 使用 capabilities/canDeleteChildren 或 capabilities/canTrashChildren。

Permissions 资源

只有位于共享云端硬盘中的文件才会填充 permissionDetails 字段。此字段是一个汇总的权限列表，其中包含该共享云端硬盘文件本身或由其继承的权限。此字段仅用于输出，并且仅适用于共享云端硬盘内容。此外，

  • 定义了 organizer 和 fileOrganizer 这两个新角色。
  • permissions.list 现在支持分页。

Changes 资源

共享云端硬盘的 Changes 资源中提供了以下新字段：

  • changeType - 更改类型。可能的值包括 file 和 drive。
  • driveId - 与此更改关联的共享云端硬盘的 ID。
  • drive - 共享云端硬盘的更新状态。如果 changeType 为 drive 且用户仍然是共享云端硬盘的成员，则此对象存在。

对于需要与共享云端硬盘同步内容或跟踪活动的应用，可能需要进行其他更改。如需了解详情，请参阅跟踪用户和共享云端硬盘的更改。