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

共享云端硬盘的组织、共享和所有权模式与“我的云端硬盘”不同。因此，对于共享云端硬盘中的内容，系统不允许执行某些“我的云端硬盘”操作。

本指南简要介绍了 files 和 changes 资源中与共享云端硬盘相关的特定 API 差异。

文件资源

files 资源中的以下字段仅针对位于共享云端硬盘中的文件进行填充：

  • hasAugmentedPermissions：是否有任何用户直接对此文件拥有文件访问权限。
  • capabilities/canAddFolderFromAnotherDrive：当前用户是否可以将其他云端硬盘（其他共享云端硬盘或“我的云端硬盘”）中的文件夹添加到此文件夹。
  • capabilities/canDeleteChildren：当前用户是否可以删除相应文件夹的子项。
  • capabilities/canMoveChildrenOutOfDrive：当前用户是否可以将相应文件夹的子项移出共享云端硬盘。
  • capabilities/canMoveChildrenWithinDrive：当前用户是否可以在共享云端硬盘中移动相应文件夹的子项。
  • capabilities/canMoveItemWithinDrive：当前用户是否可以在共享云端硬盘中移动此共享云端硬盘项。
  • capabilities/canReadDrive：当前用户是否对相应文件所属的共享云端硬盘具有读取权限。
  • capabilities/canTrashChildren：当前用户是否可以回收此文件夹的子项。
  • driveId：相应文件所在的共享云端硬盘的 ID。
  • trashingUser：如果文件已被明确放入回收站，则为将其放入回收站的用户。
  • trashedTime：相应项目被放入回收站的时间。如果您使用的是旧版 Drive API v2，则此字段称为 trashedDate。

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

  • permissions：由于共享云端硬盘访问控制列表 (ACL) 的大小可能很大，因此权限不会作为文件的一部分返回。使用支持分页的 permissions.list 方法列出共享云端硬盘或共享云端硬盘文件夹中文件的权限。
  • owners、ownerNames、ownedByMe：共享云端硬盘中的文件归共享云端硬盘所有，而不是归个人用户所有。
  • folderColorRgb：无法单独为文件夹着色。
  • shared：共享云端硬盘中的所有内容都会共享。
  • writersCanShare：无法在共享云端硬盘中按角色限制共享权限。

仅当用户已获得对某个项目的访问权限时，系统才会设置以下字段：

  • sharedWithMeDate
  • sharingUser

将以下字段与共享云端硬盘搭配使用时，需要特别注意：

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

  • parents：如果请求用户不是共享云端硬盘的成员，并且无权访问家长，则家长不会显示在家长列表中。此外，如果文件位于共享云端硬盘中，则除了顶级文件夹之外，父级列表必须只包含一项。

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

更改资源

共享云端硬盘的 changes 资源中新增了以下字段：

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

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