name: gogcli-ops description: “使用 gogcli 进行 Google Workspace 操作（Drive/Sheets/Docs/Slides）。在用户通过 gogcli 请求检查、列表、搜索、导出、读取或更新 Google 文件时使用。触发条件包括：用户询问通过 gogcli 检查、列表、搜索、导出、读取或更新 Google 文件；需要解析 Google URL/ID；需要身份验证/账户选择或安全只读工作流；或排查 gogcli 访问/错误。” description-en: Use gogcli for Google Workspace CLI operations (Drive/Sheets/Docs/Slides). Trigger when a user asks to check, list, search, export, read, or update Google files via gogcli; when a Google URL/ID needs parsing; when auth/account selection or safe read-only workflows are needed; or when troubleshooting gogcli access/errors. description-ja: “gogcli でGoogle Workspace操作（Drive/Sheets/Docs/Slides）。ユーザーがGoogleファイルの確認・検索・エクスポート・読み取り・更新をgogcliで依頼する時に使用。Trigger when a user asks to check, list, search, export, read, or update Google files via gogcli; when a Google URL/ID needs parsing; when auth/account selection or safe read-only workflows are needed; or when troubleshooting gogcli access/errors.”
Gogcli 操作
概述
标准化 gogcli 使用：验证身份验证，从 URL 解析 ID，默认进行只读检查，然后运行所需的最小命令。
快速开始
- 确认 gogcli 可用：
gog --version - 列出账户并明确选择一个如果有多个：
gog auth list - 使用
python3 scripts/gog_parse_url.py "<url-or-id>"解析 URL 为 ID - 首先运行只读元数据命令（Drive/Sheets/Docs/Slides）
工作流决策树
- 通过
scripts/gog_parse_url.py识别目标类型：sheet | doc | slide | file | folder | id | unknown。 - 选择最小的只读命令以确认访问：
- Sheets：
gog sheets metadata <spreadsheetId> - Docs：
gog docs info <docId> - Slides：
gog slides info <presentationId> - Drive 文件/文件夹：
gog drive get <fileId>或gog drive permissions <fileId>
- Sheets：
- 仅在用户明确确认后才进行写操作（更新/追加/移动/共享/删除）。
核心任务
身份验证和账户选择
- 显示存储的账户：
gog auth list - 显示身份验证配置：
gog auth status - 添加/授权账户：
gog auth add <email> - 当存在多个账户时，始终使用
--account <email>。
从 URL 解析 ID
- 解析 URL 或 ID：
python3 scripts/gog_parse_url.py "<url-or-id>"
- 如果输出类型为
unknown，请求直接 ID 或不同的 URL。
Drive（文件/文件夹）
- 列出根目录或文件夹：
gog drive ls - 按查询搜索：
gog drive search "<query>" - 获取元数据：
gog drive get <fileId> - 下载/导出：
gog drive download <fileId> - 权限检查：
gog drive permissions <fileId>
Sheets
- 元数据：
gog sheets metadata <spreadsheetId> - 读取值：
gog sheets get <spreadsheetId> <range> - 导出：
gog sheets export <spreadsheetId> - 写操作（更新/追加/清除/格式化）：需要明确确认和精确范围。
Docs
- 元数据：
gog docs info <docId> - 读取文本：
gog docs cat <docId> - 导出：
gog docs export <docId>
Slides
- 元数据：
gog slides info <presentationId> - 导出：
gog slides export <presentationId>
输出模式
- 使用
--plain获取稳定的 TSV 输出。 - 当调用者需要结构化输出时使用
--json。 - 在非交互式工作流中使用
--no-input以避免挂起。
错误处理
- 403/404：验证账户（
gog auth list），检查权限（gog drive permissions <fileId>），并确认 ID。 - 如果访问失败，请求用户与所选账户共享文件或提供正确的账户。
资源
- 查看
references/gogcli-cheatsheet.md获取紧凑的命令列表。 - 在运行命令前使用
scripts/gog_parse_url.py将 URL 标准化为 ID。