gogcli 中gog slides table column delete命令详解基于零基单元格坐标删除 Google Slides 原生表格列【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcligog slides table column delete是 gogcliGoogle Workspace in your terminal见 README.md提供的 Google Slides 原生表格列删除命令。它允许你通过表格对象 ID 与一个零基列序号--col精确定位并删除表格中的某一列同时享受 dry-run 预演、破坏性操作确认、JSON/TSV 结构化输出等 CLI 工程能力。读完本文你将掌握该命令的完整语法、全部参数语义、底层 Google Slides API 调用链DeleteTableColumnRequest以及它在批量脚本与 AI Agent 自动化场景中的安全用法。命令总览从一个零基单元格坐标说起Google Slides 中的表格由“行 × 列”网格构成gog slides table column delete删除的是包含指定零基单元格的那一列。所谓“零基”是指行与列都从 0 开始计数第 1 列的--col值为 0第 2 列为 1依此类推。这一点在文档中反复强调见 docs/commands/gog-slides-table-column-delete.md源码字段也直接命名为Zero-based column to deleteinternal/cmd/slides_table_structure.go。该命令在命令树中的完整路径为gog slides table column delete其中slides有别名slidecolumn有别名coldelete有别名rm、remove、del。因此以下写法完全等价gog slides table column delete --col1 PRESENTATION_ID TABLE_OBJECT_ID gog slides table col del --col1 PRESENTATION_ID TABLE_OBJECT_ID gog slides table column rm --col1 PRESENTATION_ID TABLE_OBJECT_ID用法与参数两个位置参数 一个必填核心 flag完整语法gog slides (slide) table column (col) delete (rm,remove,del) --colINT-64 presentationId tableObjectId位置参数参数说明presentationId演示文稿 ID即 Google Slides URL 中的那串标识符可通过 gog slides list-slides 等命令获取tableObjectId表格对象 ID唯一标识某张幻灯片上的某个表格可通过 gog slides rawPresentations.Get的无损 JSON 输出或 gog slides list-slides 获取两个位置参数均为必填。源码中slidesTableTarget会先对两者做TrimSpace并拒绝空值返回empty presentationId/empty tableObjectId的用法错误internal/cmd/slides_table_structure.go。核心 flag--colFlag类型默认说明--colint64必填要删除的列的零基序号即该列任意单元格的列下标--col在源码中标记为required:不传会直接报参数缺失错误。此外还有一层本地校验if c.Col 0 { return usage(--col must be 0) }负值会在发起任何 API 调用之前被拦截internal/cmd/slides_table_structure.go。这与同组的gog slides table row delete要求--row 0、gog slides table column insert要求--count在 120 之间保持一致的校验风格。超出表格边界的防御provider 维度复核仅靠本地负值检查还不够因为用户可能传入一个超出表格实际列数的--col。SlidesTableColumnDeleteCmd.Run在构造请求后、真正提交批量更新前会先通过Presentations.Get拉取演示文稿最新状态用findSlidesTableByID定位目标表格支持递归查找元素组ElementGroup.Children中的嵌套表格然后调用validateSlidesTableAnchor校验if col 0 || col table.Columns { return usagef(--col must be between 0 and %d, table.Columns-1) }也就是说对一个 4 列表格执行--col4会被拒绝并提示--col must be between 0 and 3且不会把越界请求发到batchUpdate接口internal/cmd/slides_table_structure.go。测试用例TestSlidesTableStructure_RejectsProviderOutOfBounds专门验证了这一行为越界时断言batchCalled falseinternal/cmd/slides_table_structure_test.go。底层实现DeleteTableColumnRequest 与完整调用链请求构造删除列的本质是构造一个 Google Slides API 的DeleteTableColumnRequest其核心语义是删除包含指定单元格cell location的列。源码实现为internal/cmd/slides_table_structure.gorequest : slides.Request{DeleteTableColumn: slides.DeleteTableColumnRequest{ TableObjectId: tableID, CellLocation: slidesTableCellLocation(0, c.Col), }}注意这里的CellLocation行下标固定为0、列下标为c.Col即“第 0 行第 col 列”这个单元格——它所在的那一列就是要被删除的列。这也解释了文档措辞“Delete the column containing a zero-based table cell”的由来。执行流程runSlidesTableMutation把请求包装进slides.BatchUpdatePresentationRequest再依次完成internal/cmd/slides_table_structure.godry-run 短路若指定了--dry-run直接打印意图并退出不触碰鉴权、keyring 或 API见下文“预演”小节。破坏性确认由于删除列是不可逆的破坏性操作命令会标记Destructive描述delete the column containing cell [0,%d] from table %s (a merged cell may span multiple columns)触发确认流程。鉴权与获取演示文稿通过requireAccountslidesService拿到 Slides API 客户端先Presentations.Get获取最新状态。定位与校验找到表格对象执行上述越界校验。并发安全若服务端返回了RevisionId则写入WriteControl.RequiredRevisionId确保“读取→修改”期间演示文稿未被他人改动避免覆盖更新这一机制由TestSlidesTableStructure_UsesRevisionAndProviderDimensions验证见 internal/cmd/slides_table_structure_test.go。提交调用Presentations.BatchUpdate执行删除。输出按当前输出格式人类可读 / JSON / TSV返回结果。合并单元格提示Destructive描述中特别注明“a merged cell may span multiple columns”合并单元格可能跨多列。如果目标单元格属于水平合并区域删除该列会影响整个合并范围因此命令的确认提示会明确告知用户这一风险防止误删。全局 flags一个破坏性命令共享的完整参数面与 gogcli 所有命令一致gog slides table column delete继承了一整套全局 flags。删除表格列属于破坏性操作下列参数尤为关键Flag类型默认说明--access-tokenstring直接使用提供的访问令牌绕过存储的 refresh token令牌约 1 小时过期-a--account--acctstring账户邮箱、别名或auto用于鉴权的 Google API 命令--clientstringOAuth 客户端名称选择存储的凭据与令牌桶--colint64要删除的零基列序号--colorstringauto颜色输出auto|always|never--disable-commandsstring逗号分隔的禁用命令列表支持点路径-n--dry-run--dryrun--noop--previewbool不实际改动打印预期操作并成功退出--enable-commandsstring逗号分隔的启用命令前缀支持点路径限制 CLI 可用范围--enable-commands-exactstring逗号分隔的精确启用命令列表点路径下父命令不会启用子命令-y--force--assume-yes--yesbool跳过破坏性命令的确认提示--gmail-no-sendboolfalse阻止 Gmail 发送操作Agent 安全-h--helpkong.helpFlag显示上下文相关帮助--homestring覆盖 gogcli 配置/数据/状态/缓存根目录等价于GOG_HOME-j--json--machineboolfalse向 stdout 输出 JSON最适合脚本化--no-input--non-interactive--noninteractivebool绝不交互提示无法满足则失败适合 CI-p--plain--tsvboolfalse输出稳定可解析的纯文本TSV无颜色--quota-projectstring计费该 API 用量的 Google Cloud 项目作为X-Goog-User-Project发送部分 API 与--access-token/ADC 组合时需要--readonlyboolfalse运行时阻止所有变更型 API 请求auth add同时只申请只读 OAuth scope--results-onlyboolJSON 模式下只输出主结果丢弃nextPageToken等信封字段--select--pick--projectstringJSON 模式下选择逗号分隔的字段尽力而为支持点路径-v--verbosebool开启详细日志--versionkong.VersionFlag打印版本并退出--wrap-untrustedboolfalseJSON/raw 输出时用外部不可信内容标记包裹抓取到的文本字段破坏性操作的三重安全网dry-run、确认、readonly删除表格列会永久移除一列数据含其中所有单元格内容gogcli 为此提供了层层防护特别适合在脚本与 AI Agent 中安全使用dry-run 预演--dry-run别名--noop、--preview会打印Dry run: would slides.table.column.delete以及完整请求体 JSON含batch_update载荷并以退出码 0 结束全程不创建 Slides 服务、不触碰鉴权与 keyringinternal/cmd/dryrun.go。测试TestSlidesTableStructure_DryRunRequests对 delete column 专门断言了 dry-run 时must not create a Slides service并校验生成的DeleteTableColumnRequest中TableObjectId table1、CellLocation.RowIndex 0、CellLocation.ColumnIndex 3internal/cmd/slides_table_structure_test.go。交互确认未加--force时命令会提示Proceed to delete the column containing cell [0,N] from table id ...? [y/N]:只有输入y才会继续--no-input或非交互终端下会直接失败并提示refusing to ... without --force (non-interactive)internal/cmd/confirm.go。readonly 硬开关--readonly会在运行时层面拦截所有变更型 API 请求删除类操作自然被禁止可作为只读巡检或 Agent 沙箱的兜底。实际脚本化执行时可组合使用例如先预演再执行# 预演只打印将要做的事 gog slides table column delete --dry-run --col2 PRES_ID TABLE_ID # 真实执行非交互跳过确认 gog slides table column delete --force --no-input --col2 PRES_ID TABLE_ID输出格式与脚本化消费命令成功后默认输出人类可读文本例如Deleted column 2 from table tableObjectId。面向脚本或 LLM 消费时推荐使用JSON 模式-j/--json/--machine输出结构化结果包含presentationId、tableObjectId、col、deleted: true字段便于程序判断结果internal/cmd/slides_table_structure.goTSV 模式-p/--plain/--tsv输出稳定、可解析、无颜色的纯文本dry-run 组合--dry-run -j会输出{dry_run: true, op: slides.table.column.delete, request: {...}}适合在 CI 中先行验证。配合--quota-project可以在使用临时--access-token或 ADC调用部分 API 时正确计费到指定 Google Cloud 项目。相关命令与进一步探索gog slides table column列的插入、删除、尺寸调整入口包含insert--count120、--right控制插入方向与size子命令gog slides table完整原生表格操作家族创建、合并、取消合并、行/列/单元格/边框样式等gog slidesgog slides下的全部演示文稿命令Command indexgogcli 全量命令索引。若希望从源码层面进一步理解实现核心实现在 internal/cmd/slides_table_structure.go相关的 dry-run 与确认逻辑分别在 internal/cmd/dryrun.go 与 internal/cmd/confirm.go行为验证可参考 internal/cmd/slides_table_structure_test.go 中的 dry-run 请求断言、provider 维度校验与本地负值校验等测试用例。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
gogcli 中gog slides table column delete命令详解基于零基单元格坐标删除 Google Slides 原生表格列【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcligog slides table column delete是 gogcliGoogle Workspace in your terminal见 README.md提供的 Google Slides 原生表格列删除命令。它允许你通过表格对象 ID 与一个零基列序号--col精确定位并删除表格中的某一列同时享受 dry-run 预演、破坏性操作确认、JSON/TSV 结构化输出等 CLI 工程能力。读完本文你将掌握该命令的完整语法、全部参数语义、底层 Google Slides API 调用链DeleteTableColumnRequest以及它在批量脚本与 AI Agent 自动化场景中的安全用法。命令总览从一个零基单元格坐标说起Google Slides 中的表格由“行 × 列”网格构成gog slides table column delete删除的是包含指定零基单元格的那一列。所谓“零基”是指行与列都从 0 开始计数第 1 列的--col值为 0第 2 列为 1依此类推。这一点在文档中反复强调见 docs/commands/gog-slides-table-column-delete.md源码字段也直接命名为Zero-based column to deleteinternal/cmd/slides_table_structure.go。该命令在命令树中的完整路径为gog slides table column delete其中slides有别名slidecolumn有别名coldelete有别名rm、remove、del。因此以下写法完全等价gog slides table column delete --col1 PRESENTATION_ID TABLE_OBJECT_ID gog slides table col del --col1 PRESENTATION_ID TABLE_OBJECT_ID gog slides table column rm --col1 PRESENTATION_ID TABLE_OBJECT_ID用法与参数两个位置参数 一个必填核心 flag完整语法gog slides (slide) table column (col) delete (rm,remove,del) --colINT-64 presentationId tableObjectId位置参数参数说明presentationId演示文稿 ID即 Google Slides URL 中的那串标识符可通过 gog slides list-slides 等命令获取tableObjectId表格对象 ID唯一标识某张幻灯片上的某个表格可通过 gog slides rawPresentations.Get的无损 JSON 输出或 gog slides list-slides 获取两个位置参数均为必填。源码中slidesTableTarget会先对两者做TrimSpace并拒绝空值返回empty presentationId/empty tableObjectId的用法错误internal/cmd/slides_table_structure.go。核心 flag--colFlag类型默认说明--colint64必填要删除的列的零基序号即该列任意单元格的列下标--col在源码中标记为required:不传会直接报参数缺失错误。此外还有一层本地校验if c.Col 0 { return usage(--col must be 0) }负值会在发起任何 API 调用之前被拦截internal/cmd/slides_table_structure.go。这与同组的gog slides table row delete要求--row 0、gog slides table column insert要求--count在 120 之间保持一致的校验风格。超出表格边界的防御provider 维度复核仅靠本地负值检查还不够因为用户可能传入一个超出表格实际列数的--col。SlidesTableColumnDeleteCmd.Run在构造请求后、真正提交批量更新前会先通过Presentations.Get拉取演示文稿最新状态用findSlidesTableByID定位目标表格支持递归查找元素组ElementGroup.Children中的嵌套表格然后调用validateSlidesTableAnchor校验if col 0 || col table.Columns { return usagef(--col must be between 0 and %d, table.Columns-1) }也就是说对一个 4 列表格执行--col4会被拒绝并提示--col must be between 0 and 3且不会把越界请求发到batchUpdate接口internal/cmd/slides_table_structure.go。测试用例TestSlidesTableStructure_RejectsProviderOutOfBounds专门验证了这一行为越界时断言batchCalled falseinternal/cmd/slides_table_structure_test.go。底层实现DeleteTableColumnRequest 与完整调用链请求构造删除列的本质是构造一个 Google Slides API 的DeleteTableColumnRequest其核心语义是删除包含指定单元格cell location的列。源码实现为internal/cmd/slides_table_structure.gorequest : slides.Request{DeleteTableColumn: slides.DeleteTableColumnRequest{ TableObjectId: tableID, CellLocation: slidesTableCellLocation(0, c.Col), }}注意这里的CellLocation行下标固定为0、列下标为c.Col即“第 0 行第 col 列”这个单元格——它所在的那一列就是要被删除的列。这也解释了文档措辞“Delete the column containing a zero-based table cell”的由来。执行流程runSlidesTableMutation把请求包装进slides.BatchUpdatePresentationRequest再依次完成internal/cmd/slides_table_structure.godry-run 短路若指定了--dry-run直接打印意图并退出不触碰鉴权、keyring 或 API见下文“预演”小节。破坏性确认由于删除列是不可逆的破坏性操作命令会标记Destructive描述delete the column containing cell [0,%d] from table %s (a merged cell may span multiple columns)触发确认流程。鉴权与获取演示文稿通过requireAccountslidesService拿到 Slides API 客户端先Presentations.Get获取最新状态。定位与校验找到表格对象执行上述越界校验。并发安全若服务端返回了RevisionId则写入WriteControl.RequiredRevisionId确保“读取→修改”期间演示文稿未被他人改动避免覆盖更新这一机制由TestSlidesTableStructure_UsesRevisionAndProviderDimensions验证见 internal/cmd/slides_table_structure_test.go。提交调用Presentations.BatchUpdate执行删除。输出按当前输出格式人类可读 / JSON / TSV返回结果。合并单元格提示Destructive描述中特别注明“a merged cell may span multiple columns”合并单元格可能跨多列。如果目标单元格属于水平合并区域删除该列会影响整个合并范围因此命令的确认提示会明确告知用户这一风险防止误删。全局 flags一个破坏性命令共享的完整参数面与 gogcli 所有命令一致gog slides table column delete继承了一整套全局 flags。删除表格列属于破坏性操作下列参数尤为关键Flag类型默认说明--access-tokenstring直接使用提供的访问令牌绕过存储的 refresh token令牌约 1 小时过期-a--account--acctstring账户邮箱、别名或auto用于鉴权的 Google API 命令--clientstringOAuth 客户端名称选择存储的凭据与令牌桶--colint64要删除的零基列序号--colorstringauto颜色输出auto|always|never--disable-commandsstring逗号分隔的禁用命令列表支持点路径-n--dry-run--dryrun--noop--previewbool不实际改动打印预期操作并成功退出--enable-commandsstring逗号分隔的启用命令前缀支持点路径限制 CLI 可用范围--enable-commands-exactstring逗号分隔的精确启用命令列表点路径下父命令不会启用子命令-y--force--assume-yes--yesbool跳过破坏性命令的确认提示--gmail-no-sendboolfalse阻止 Gmail 发送操作Agent 安全-h--helpkong.helpFlag显示上下文相关帮助--homestring覆盖 gogcli 配置/数据/状态/缓存根目录等价于GOG_HOME-j--json--machineboolfalse向 stdout 输出 JSON最适合脚本化--no-input--non-interactive--noninteractivebool绝不交互提示无法满足则失败适合 CI-p--plain--tsvboolfalse输出稳定可解析的纯文本TSV无颜色--quota-projectstring计费该 API 用量的 Google Cloud 项目作为X-Goog-User-Project发送部分 API 与--access-token/ADC 组合时需要--readonlyboolfalse运行时阻止所有变更型 API 请求auth add同时只申请只读 OAuth scope--results-onlyboolJSON 模式下只输出主结果丢弃nextPageToken等信封字段--select--pick--projectstringJSON 模式下选择逗号分隔的字段尽力而为支持点路径-v--verbosebool开启详细日志--versionkong.VersionFlag打印版本并退出--wrap-untrustedboolfalseJSON/raw 输出时用外部不可信内容标记包裹抓取到的文本字段破坏性操作的三重安全网dry-run、确认、readonly删除表格列会永久移除一列数据含其中所有单元格内容gogcli 为此提供了层层防护特别适合在脚本与 AI Agent 中安全使用dry-run 预演--dry-run别名--noop、--preview会打印Dry run: would slides.table.column.delete以及完整请求体 JSON含batch_update载荷并以退出码 0 结束全程不创建 Slides 服务、不触碰鉴权与 keyringinternal/cmd/dryrun.go。测试TestSlidesTableStructure_DryRunRequests对 delete column 专门断言了 dry-run 时must not create a Slides service并校验生成的DeleteTableColumnRequest中TableObjectId table1、CellLocation.RowIndex 0、CellLocation.ColumnIndex 3internal/cmd/slides_table_structure_test.go。交互确认未加--force时命令会提示Proceed to delete the column containing cell [0,N] from table id ...? [y/N]:只有输入y才会继续--no-input或非交互终端下会直接失败并提示refusing to ... without --force (non-interactive)internal/cmd/confirm.go。readonly 硬开关--readonly会在运行时层面拦截所有变更型 API 请求删除类操作自然被禁止可作为只读巡检或 Agent 沙箱的兜底。实际脚本化执行时可组合使用例如先预演再执行# 预演只打印将要做的事 gog slides table column delete --dry-run --col2 PRES_ID TABLE_ID # 真实执行非交互跳过确认 gog slides table column delete --force --no-input --col2 PRES_ID TABLE_ID输出格式与脚本化消费命令成功后默认输出人类可读文本例如Deleted column 2 from table tableObjectId。面向脚本或 LLM 消费时推荐使用JSON 模式-j/--json/--machine输出结构化结果包含presentationId、tableObjectId、col、deleted: true字段便于程序判断结果internal/cmd/slides_table_structure.goTSV 模式-p/--plain/--tsv输出稳定、可解析、无颜色的纯文本dry-run 组合--dry-run -j会输出{dry_run: true, op: slides.table.column.delete, request: {...}}适合在 CI 中先行验证。配合--quota-project可以在使用临时--access-token或 ADC调用部分 API 时正确计费到指定 Google Cloud 项目。相关命令与进一步探索gog slides table column列的插入、删除、尺寸调整入口包含insert--count120、--right控制插入方向与size子命令gog slides table完整原生表格操作家族创建、合并、取消合并、行/列/单元格/边框样式等gog slidesgog slides下的全部演示文稿命令Command indexgogcli 全量命令索引。若希望从源码层面进一步理解实现核心实现在 internal/cmd/slides_table_structure.go相关的 dry-run 与确认逻辑分别在 internal/cmd/dryrun.go 与 internal/cmd/confirm.go行为验证可参考 internal/cmd/slides_table_structure_test.go 中的 dry-run 请求断言、provider 维度校验与本地负值校验等测试用例。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 完全指南：从右向左的函数组合与 Store Enhancer 应用)
