实现共享云端硬盘支持

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

共享云端硬盘遵循与“我的云端硬盘”中不同的组织、共享和所有权模式。如果您的应用要创建和管理共享云端硬盘中的文件,您必须在应用中实现共享云端硬盘支持。实现的复杂程度取决于应用的功能。

首先,当您的应用执行下列操作时,您需要在请求中包含 supportsAllDrives=true 查询参数:

云端硬盘 API v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

云端硬盘 API v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

supportsAllDrives=true 参数会告知 Google 云端硬盘,您的应用旨在处理共享云端硬盘中的文件。

读取或修改权限、跟踪更改或者需要搜索多个语料库的应用都需要额外的共享云端硬盘功能。 本文档的其余部分重点介绍执行这些任务所需的其他更改。

搜索共享云端硬盘中的内容

使用 files.list 方法搜索共享云端硬盘。本部分将介绍 files.list 方法中的共享云端硬盘专用字段。如需搜索共享云端硬盘,请参阅搜索文件和文件夹

files.list 方法包含以下共享云端硬盘专用字段和查询模式:

  • driveId - 要搜索的共享云端硬盘的 ID。
  • includeItemsFromAllDrives - 是否应将共享云端硬盘内容包含在结果中。如果不存在或设置为 false,则系统不会返回共享云端硬盘内容。

  • corpora - 要查询的项目(文件/文档)正文。支持的正文包括 userdomaindriveallDrives。为了提高效率,优先选择 userdrive

  • supportsAllDrives - 发出请求的应用是否支持“我的云端硬盘”和共享云端硬盘。如果为 false,则响应中不会包含共享云端硬盘内容。

以下查询模式专用于共享云端硬盘:

includeItemsFromAllDrives corpora 查询说明
true user 查询用户访问过的文件,包括共享云端硬盘和“我的云端硬盘”中的文件。
true drive 查询指定共享云端硬盘中的所有内容。必须在请求中指定 driveId。
true allDrives 查询用户访问过的文件以及他们所属的所有共享云端硬盘。请注意,响应可能包含 incompleteSearch : true,这表示搜索该请求的部分内容没有搜索到。
true domain 查询与网域共享的文件,包括共享云端硬盘和“我的云端硬盘”中的文件。

跟踪共享云端硬盘的更改

使用 changes.list 方法跟踪共享云端硬盘的更改。本部分将介绍 changes.list 方法中的共享云端硬盘专用字段。如需了解详情,请参阅跟踪用户和共享云端硬盘的变化changes.list 方法包含以下共享云端硬盘专用字段和查询模式:

  • driveId - 从中返回更改的共享云端硬盘。如果已指定,则更改 ID 是指对共享云端硬盘中的更改,而不是对向用户显示的文件的更改。如需引用特定共享云端硬盘的更改,则共享云端硬盘 ID 和更改 ID 都必须用作标识符。
  • supportsAllDrives - 发出请求的应用是否支持共享云端硬盘。如果为 false,则系统不会返回共享云端硬盘内容,包括共享云端硬盘和共享云端硬盘中的文件。
  • includeItemsFromAllDrives - 是否应将共享云端硬盘或更改内容包含在更改列表中。

以下查询模式专用于共享云端硬盘:

includeItemsFromAllDrives driveId 查询说明
true 更改会反映用户访问过的共享云端硬盘内外的文件的变化,以及用户所属的共享云端硬盘的变化。
true 更改反映了对指定共享云端硬盘及其中内容的更改。

如需详细了解变更日志行为,请参阅变更日志

在云端硬盘界面中启用共享云端硬盘支持

如需使用云端硬盘界面访问共享云端硬盘内容,请确保您已在 Google API 控制台中勾选“共享云端硬盘支持”。如需了解详情,请参阅配置云端硬盘界面集成

将文件选择器与共享云端硬盘搭配使用

文件选择器支持选择共享云端硬盘中的内容。 如需详细了解如何在文件选择器中启用共享云端硬盘支持以及如何添加共享云端硬盘视图,请参阅 Google Picker API

后续步骤

有关创建共享云端硬盘和管理共享云端硬盘权限的帮助,请参阅管理共享云端硬盘