此页面由 Cloud Translation API 翻译。

实现共享云端硬盘支持

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

首先，当应用执行以下列出的操作时，您需要在请求中添加 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`	是	更改反映了指定共享云端硬盘及其内部内容的更改。

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

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

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

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