请参阅 Application Integration 支持的连接器。

“云端硬盘 - 列出”任务

通过云端硬盘 - 列出任务，您可以搜索和检索存储在 Google 云端硬盘账号中的文件和文件夹。

Google 云端硬盘是一项云文件存储服务，可为您提供个人存储空间，供您存储和访问云端的协作共享文件和文件夹。

准备工作

在配置云端硬盘 - 列表任务之前，请务必在 Google Cloud 项目中执行以下任务：

启用 Google Drive API (drive.googleapis.com)。
启用 Google Drive API
创建身份验证配置文件。Application Integration 使用身份验证配置文件连接到云端硬盘 - 列表任务的身份验证端点。
如需了解如何向服务账号授予其他角色或权限，请参阅授予、更改和撤消访问权限。

配置云端硬盘 - 列表任务

在 Google Cloud 控制台中，前往 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击 Integrations（集成）。
系统随即会显示集成页面，其中列出了 Google Cloud 项目中提供的所有集成。
选择现有集成，或点击创建集成以创建新集成。
要创建新的集成，请执行以下操作：
1. 在 Create Integration（创建集成）窗格中输入名称和说明。
2. 选择集成区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
  注意：仅当您为所选区域启用了集成治理时，系统才会显示用于选择服务帐号的选项。
4. 点击创建。
系统会在集成编辑器中打开集成。
在集成编辑器导航栏中，点击 Tasks 以查看可用任务列表。
点击云端硬盘 - 列表元素，并将其放置在集成编辑器中。
点击设计器上的云端硬盘 - 列出元素以查看云端硬盘 - 列出任务配置窗格。
前往身份验证，然后选择您要使用的现有身份验证配置文件。
可选。如果您在配置此任务之前未创建身份验证配置文件，请点击 + New authentication profile（+ 新建身份验证配置文件），然后按照创建新的身份验证配置文件中所述的步骤操作。
前往 Task Input（任务输入），然后使用以下任务输入参数表配置所需的输入字段。
系统会自动保存对输入字段的更改。

任务输入参数

下表介绍了云端硬盘 - 列出任务的输入参数：

属性	数据类型	说明
`Corpora`	字符串	（可选）用于搜索语料库中的文件的参数。
`DriveId`	字符串	您的 Google 共享云端硬盘的 ID。
`IncludeItemsFromAllDrives`	布尔值	如果您想在搜索结果中同时显示个人云端硬盘和共享云端硬盘内容，请将该值设为 `true`。默认值为 `false`。
`IncludeLabels`	字符串	响应的 `labelInfo` 部分中包含的标签 ID 列表（以英文逗号分隔）。如需详细了解标签 ID，请参阅标签概览。
`IncludePermissionsForView`	字符串	指定 `published`。有关详情，请参阅共享文件、文件夹和云端硬盘。
`OrderBy`	字符串	文件的排序顺序。可接受的值如下： `createdTime` `folder` `modifiedByMeTime` `modifiedTime` `name` `name_natural` `quotaBytesUsed` `recency` `sharedWithMeTime` `starred` `viewedByMeTime`
`PageSize`	整数	每页返回的文件数量上限。可接受的值为 `1` 到 `1000`。默认值为 `100`。
`PageToken`	字符串	用于继续执行之前的云端硬盘 - 列出任务的令牌。将此值设置为上一个响应中的 `nextPageToken` 的值。
`Q`	字符串	用于过滤文件结果的查询。有关详情，请参阅搜索文件。
`Spaces`	字符串	要在语料库中查询的空格列表（以英文逗号分隔）。可接受的值为 `drive` 和 `appDataFolder`。
`SupportsAllDrives`	布尔值	如果发出请求的应用同时支持“我的云端硬盘”和共享云端硬盘，请将该值设置为 `true`。默认值为 `false`。

任务输出

云端硬盘 - 列出任务会返回包含文件列表的响应输出。以下是示例输出：

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。