实现共享云端硬盘支持

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

首先，当您的应用执行以下操作时，您需要在请求中添加 supportsAllDrives=true 查询参数：

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

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

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

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

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

• driveId - 要搜索的共享云端硬盘的 ID。

• includeItemsFromAllDrives - 是否应将共享云端硬盘内容包含在结果中。如果此字段不存在或设置为 false，系统不会返回共享云端硬盘内容。

• corpora - 要查询的项（文件/文档）的正文。支持的正文包括 user、domain、drive 和 allDrives。为了提高效率，请优先使用 user 或 drive，而不是 allDrives。

• 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 控制台中选中“共享云端硬盘支持”。如需了解详情，请参阅配置 Drive 界面集成。

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

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

后续步骤

如需有关创建共享云端硬盘和管理共享云端硬盘权限的帮助，请继续参阅管理共享云端硬盘。