“云端硬盘 - 列出”任务

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

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

须知事项

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

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

配置“云端硬盘 - 列出”任务

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

任务输入参数

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

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

任务输出

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

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

错误处理策略

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

配额和限制

如需了解配额和限制，请参阅配额和限制。