Google Drive 概览 | Alephant Documentation

使用 Google Drive 连接器可将已批准的 Drive 内容索引为文档集。Google 凭据由 Admin 创建和维护，并由 Admin 在配置连接器时选择或关联。请将连接器限制为已授权内容，并在把结果附加给 Agent 前验证每次索引尝试。

工作方式

连接器使用其保存的凭据向 Google Drive 认证，在所选范围内发现内容并创建一次索引尝试。尝试成功后，可将已索引内容组织为所需 Agent 的文档集。

连接器的访问同时受所选范围和凭据获授权限限制。文档集不会绕过 Google Drive 权限，也不会让 Agent 直接访问 Drive。

请索引所选凭据在指定范围内可读取的内容。扩大范围前，请确认内容所有者同意索引，且内容适合将要使用该文档集的 Agent。

内容类型	常见支持格式
Google 原生文件	Google Docs、Sheets 和 Slides。
常见上传文件	PDF、DOCX、PPTX、XLSX/XLSM、CSV/TSV、TXT/Markdown，以及 JSON/XML/YAML。
图像	部署启用图像处理时支持 JPG/JPEG、PNG 和 WebP。

这不是穷尽的格式列表。Google Drive 的可用性、来源端权限和文件解析都可能影响索引尝试；无法解析、不受支持或超过大小限制的文件可能被跳过。请检查索引尝试结果及报告的错误，不要假定所有已选择项目都已被索引。

方式	适用场景	管理边界
OAuth App	获授权人员可为待索引的 Drive 内容完成浏览器授权。	Admin 上传和维护 OAuth 凭据，并为连接器选择或关联该凭据。
Service Account	组织通过已批准的服务身份和所需委派管理 Google Workspace 访问。	Workspace 管理员和 OpenCore Admin 配置凭据；OpenCore Admin 为连接器选择或关联该凭据。

请选择与组织 Google Drive 管理模式相符的方式。所有者、环境或访问边界不同时，请使用独立凭据。

范围	用途
My Drive	已认证用户拥有或可访问的 My Drive 内容。
Shared Drives	凭据获准访问的 Shared Drives 中的内容。
Shared with me	与已认证用户共享且适合索引的内容。
Drive URL	由已批准 URL 标识的一个指定 Drive。
Folder URL	由已批准 URL 标识的一个指定文件夹，以及连接器从该文件夹选择的内容。

请从最小的已批准范围开始。验证首次索引尝试后，只有获得内容所有者和部署策略批准时才扩大范围。

当内容所有者、Google 环境或访问边界不同时，Admin 可以创建多个凭据并将它们关联到多个连接器。请让每个连接器的凭据和范围便于审查；当索引内容应提供给不同 Agent 或受众时，请使用不同文档集。

变更或撤销某一凭据只会影响使用它的连接器。凭据、权限或范围变化后，请重新检查受影响连接器并运行一次新的索引尝试。