借助适用于 Gemini Enterprise 的 Google 云端硬盘数据存储区，您可以搜索 Google 云端硬盘数据（包括文件和文件夹）并对其执行操作。
支持的操作
启用 Google 云端硬盘数据存储区后，最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。
| 操作 | 说明 |
|---|---|
| 复制文件 | 复制 Google 云端硬盘中的文件。 |
| 创建文件 | 在 Google 云端硬盘中创建新文件。 |
| 下载文件内容 | 下载 Google 云端硬盘文件的内容。 |
| 获取单元格值 | 从 Google 表格电子表格中读取单元格值。 |
| 获取文件元数据 | 提取 Google 云端硬盘文件的元数据。 |
| 获取文件权限 | 列出 Google 云端硬盘文件的权限。 |
| 获取电子表格 | 读取 Google 表格电子表格的内容和元数据。 |
| 插入行或列 | 在 Google 表格电子表格中插入行或列。 |
| 列出近期文件 | 列出 Google 云端硬盘中的近期文件。 |
| 列出共享云端硬盘 | 列出 Google 云端硬盘中的共享云端硬盘。 |
| 读取文档 | 读取 Google 文档的内容。 |
| 读取文件内容 | 读取 Google 云端硬盘文件的内容。 |
| 朗读演示文稿 | 读取 Google 幻灯片演示文稿的内容。 |
| 搜索文件 | 搜索与查询匹配的 Google 云端硬盘文件。 |
| 分享文件 | 与一位或多位用户共享 Google 云端硬盘文件。 |
| 将文件移至回收站 | 将 Google 云端硬盘文件移至回收站。 |
| 更新单元格值 | 将单元格值写入 Google 表格电子表格。 |
| 更新文件 | 更新现有 Google 云端硬盘文件。 |
| 更新公式 | 将公式写入 Google 表格电子表格。 |
必需的范围
Google管理的 OAuth 应用会请求以下 OAuth 范围。 用户在授权连接器时会授予以下范围：
| 范围 | 用途 |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
搜索和检索 Google 云端硬盘内容。允许数据存储区列出文件和文件夹、查看元数据、列出权限以及读取文件内容。 |
https://www.googleapis.com/auth/drive.metadata.readonly |
读取 Google 云端硬盘文件元数据。 |
https://www.googleapis.com/auth/drive.file |
创建和更新用户通过连接器打开或创建的文件。 |
https://www.googleapis.com/auth/drive.appdata |
在 Google 云端硬盘中存储应用专属数据。 |
https://www.googleapis.com/auth/drive |
对 Google 云端硬盘文件执行写入操作（例如复制、共享、移至回收站和更新）。 |
限制
- Google 云端硬盘数据存储区仅在
global、us和eu位置受支持。
如果您使用安全控制措施，请注意下表中讨论的与 Google 云端硬盘中的数据相关的限制：
安全控制 请注意以下几点 数据驻留 (DRZ) Gemini Enterprise 仅保证数据驻留在 Google Cloud中。如需了解数据驻留和 Google 云端硬盘，请参阅 Google Workspace 合规性指导和文档，包括 Google Workspace 的数据区域。另请查看相关示例，例如选择数据存储区域和数字主权。 客户管理的加密密钥 (CMEK) 您的密钥仅加密 Google Cloud内的数据。Cloud Key Management Service 的控制措施不适用于存储在 Google 云端硬盘中的数据。 Access Transparency Access Transparency 会记录 Google 员工在 Google Cloud 项目中执行的操作。您还需要查看 Google Workspace 创建的 Access Transparency 日志。如需了解详情，请参阅 Google Workspace 管理员帮助文档中的 Access Transparency 日志事件。
常见搜索问题
如果搜索未返回您要查找的文件，或者 Gemini Enterprise Web 应用报告未找到匹配的 Google 云端硬盘文件，请查看以下问题和解决方案。
Gemini Enterprise 对 Google Workspace 数据的访问权限已被停用
症状：Gemini Enterprise Web 应用报告未找到匹配的 Google 云端硬盘文件，或者通过 Search API 发送的搜索请求返回 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin. 错误（或警告）。您还可以在 Cloud Logging 中检查数据存储区错误日志；请参阅排查 Gemini Enterprise 数据存储区问题。
问题：用户所属 Google Workspace 组织的 Google 管理控制台中已关闭允许 Gemini Enterprise 访问 Google Workspace 数据设置。
解决方案：请让用户所在组织的 Google Workspace 管理员开启允许 Gemini Enterprise 访问 Google Workspace 数据。在跨组织设置中，每个 Google Workspace 组织中其用户查询 Google 云端硬盘的管理员都必须启用此设置。
用户和数据存储区属于不同的 Google Workspace 组织
症状：如果用户从与 Google Cloud 项目不同的 Google Workspace 组织登录，则不会在 Gemini Enterprise Web 应用中收到 Google 云端硬盘结果，或者通过 Search API 发送的请求会返回 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
... 错误。如需在日志中检查 403 错误，请参阅使用 Cloud Logging 访问 Gemini Enterprise 连接器错误日志。
问题：默认情况下，只有当用户的 Google Workspace 客户 ID 与 Google 云端硬盘数据存储区和 Google Cloud 项目的组织匹配时，Gemini Enterprise 才允许用户搜索 Google 云端硬盘数据存储区。
解决方案：完成跨组织设置：
- 请与 Cloud Customer Care 联系，将每个 Google Workspace 组织（其用户访问 Gemini Enterprise）的客户 ID 添加到 Google Cloud 项目的许可清单中。
- 让每个 Google Workspace 组织中的 Google Workspace 管理员开启允许 Gemini Enterprise 访问 Google Workspace 数据。
- 如果用户需要查找其所在组织外部拥有的文档，请在管理 Web 应用功能中启用包含跨网域文档。
超出 1 MB 文本提取限制的关键字无法搜索
症状：搜索大文件中较后位置出现的关键字时，系统不会返回该文件。
问题：Google 云端硬盘只会从您的文件中提取 1 MB 的文本和格式设置数据，以使其可搜索。它无法搜索超过 1 MB 索引限制的关键字。
解决方案：使用文件前 1 MB 中出现的字词进行搜索，或将大型文档拆分为较小的文件。
超出大小或 PDF 页数限制的文件不会被编入索引
症状：特定大文件或长 PDF 文件未显示在搜索结果中。
问题：超出 Google 云端硬盘大小或页数限制的文件不会被编入索引，也不会显示在搜索结果中：
- 对于大多数文件类型，文件大小不得超过 10 MB，但以下情况除外：
- XLSX 文件：不超过 20 MB。
- PDF 文件：不超过 30 MB。
- 文本文件：不超过 100 MB。
- PDF 文件中的光学字符识别 (OCR) 功能仅支持处理不超过 80 页的文件。 Google 云端硬盘不会将任何大于 50 MB 或 80 页的 PDF 文件编入索引。
解决方案：减小文件大小，或拆分超出这些索引编制限制的文件和 PDF。
后续步骤
- 如需创建和配置 Google 云端硬盘数据存储区，请参阅设置 Google 云端硬盘数据存储区。