> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# Google Drive 概览

> 将内容索引到 OpenCore 知识库前，选择已批准的 Google Drive 认证方式和范围。

使用 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 或受众时，请使用不同文档集。

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

## 后续步骤

* [Google Drive OAuth](/opencore/knowledge/google-drive/oauth) 指导使用 OAuth App 完成基于浏览器的授权。
* [Google Drive Service Account](/opencore/knowledge/google-drive/service-account) 介绍组织管理的服务身份配置。
* [连接器与索引](/opencore/knowledge/connectors) 说明文档集、索引尝试和 Standard 模式要求。