共享云端硬盘与 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 方法。 支持分页,用于列出某个 或共享云端硬盘本身。
  • ownersownerNamesownedByMe - 共享云端硬盘中的文件 所有者是共享云端硬盘,而不是个人用户。
  • folderColorRgb - 无法单独为文件夹着色
  • shared - 共享云端硬盘中的所有内容均已共享。
  • writersCanShare - 目前无法通过以下对象限制分享: 角色。

仅当用户获得文件访问权限后,系统才会设置以下字段 项的权限:

  • sharedWithMeDate
  • sharingUser

将以下字段与 结合使用时,需要特别注意 共享云端硬盘:

  • parents.isRoot - 此字段仅适用于“我的云端硬盘”根文件夹; 对于共享云端硬盘顶级文件夹,则为 false。
  • parents - 如果父级没有显示在父级列表中, 提出请求的用户不是该共享云端硬盘的成员,也没有访问权限 父级此外,除了顶层文件夹外, 如果文件位于 共享云端硬盘。

  • capabilities/canRemoveChildren - 使用 capabilities/canDeleteChildrencapabilities/canTrashChildren

Permissions 资源

permissionDetails字段只对位于 共享云端硬盘。此字段是 或由此共享云端硬盘文件继承的设置。此字段是仅限输出的字段, 仅适用于共享云端硬盘内容。此外,

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

Changes 资源

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

  • changeType - 更改的类型。可能的值包括 filedrive
  • driveId - 与此更改相关联的共享云端硬盘的 ID。
  • drive - 共享云端硬盘的更新状态。如果存在 changeType的年龄是 drive,且仍是共享云端硬盘的成员。

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