需先配置Google Cloud项目并启用Drive API，再通过MuleRun的googledriveconnect命令建立OAuth连接，接着用gdrive_search查找文件ID，然后用gdrive_read_file读取内容，最后可选gsheets_read按范围提取表格数据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在MuleRun环境中调用Google Drive中的文件，需先建立稳定、授权有效的连接。MuleRun作为零门槛个人AI平台，不依赖本地部署，但需通过标准OAuth 2.0流程获取访问权限，并将凭证注入运行时上下文。以下是实现连接与文件调用的具体步骤：
一、配置Google Cloud项目并启用Drive API
该步骤为所有后续操作的前提，确保Google Drive API已激活且具备合法调用资质。未完成此配置将导致认证失败或403拒绝访问错误。
1、访问 https://console.cloud.google.com/ 并使用目标Google账号登录。
2、创建新项目或选择已有项目，在左侧导航栏进入“API和服务”→“库”。
3、搜索 Google Drive API，点击启用。
4、进入“凭据”页面，点击“创建凭据”→“OAuth客户端ID”，选择“Web应用”类型。
5、在“授权重定向URI”中添加 https://mulerun.ai/oauth/callback（以MuleRun官方回调域为准）。
二、在MuleRun中执行googledriveconnect命令
MuleRun通过内置的 googledriveconnect 命令完成连接初始化，该命令将返回一个可复用的文件系统变量，用于后续所有gdrive相关操作。
1、在MuleRun工作流编辑器中插入命令节点，输入指令：googledriveconnect --name mydrive --type filesystem。
2、确认参数 --name 值为唯一标识符（如mydrive），不可与其他连接名重复。
3、运行流程，系统将自动跳转至Google OAuth授权页；用户需登录对应账号并授予权限 https://www.googleapis.com/auth/drive.readonly 或读写权限。
4、授权成功后，MuleRun接收令牌并生成 filesystem 类型变量，保存至指定变量名（如mydrive）。
三、使用gdrive_search检索目标文件
连接建立后，需定位具体文件ID才能进行读取或操作。gdrive_search组件支持基于名称、MIME类型、父文件夹等条件的精准查询，避免手动查找ID。
1、添加 gdrive_search 组件至流程，绑定上一步生成的 mydrive 变量。
2、设置 query 参数，例如 name contains 'report' and mimeType = 'application/vnd.google-apps.spreadsheet'。
3、指定 pageSize 为 10，防止单次响应过大影响解析效率。
4、执行后输出结果包含匹配文件的 fileId、name 和 mimeType 字段，供后续步骤引用。
四、调用gdrive_read_file读取文件内容
获取有效fileId后，即可触发内容拉取。该操作会根据文件类型自动执行导出转换，例如Google Docs转Markdown、Sheets转CSV，无需额外格式处理逻辑。
1、插入 gdrive_read_file 组件，输入字段 fileId 填入上一步输出的ID值。
2、确保该组件的 filesystem 输入连接至同一 mydrive 变量。
3、运行组件，MuleRun向Google Drive API发起GET请求，接收原始字节流并按类型解码。
4、输出内容直接为文本字符串（如Markdown）或结构化数据（如CSV解析后的数组），可立即送入下游处理节点。
五、通过gsheets_read读取表格特定范围
当目标为Google Sheets且仅需部分单元格数据时，gsheets_read提供A1标记范围控制能力，避免整表加载造成延迟或内存溢出。
1、添加 gsheets_read 组件，填入 spreadsheetId（即fileId）。
2、设置 ranges 参数为数组格式，例如 ["Sheet1!A1:D10", "Summary!B2:B5"]。
3、若需读取单一工作表且无命名冲突，可省略 sheetId 参数。
4、执行后输出为JSON对象，每个range键对应一个二维数组，行优先排列，首行为标题行（若存在）。
