gogcligog slides element delete命令详解批量删除 Google Slides 页面元素【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcligog slides element delete是 gogcliGoogle Workspace in your terminal中用于删除 Google Slides 演示文稿页面元素形状、线条、图片、文本框、表格、组等的核心命令。它支持在一条命令中删除任意数量的页面元素并内置 dry-run 预演、破坏性操作确认、JSON 输出等安全与自动化机制。阅读本文后你将掌握该命令的完整用法、全部可用标志位、底层 Google Slides API 调用链以及如何结合脚本与 CI 安全地执行元素清理。命令概览与使用场景该命令的命令路径为gog slides element delete同时提供别名rm。它归属于 gog slides element 子命令族该族还包括 create-shape、create-line、transform、style、z-order、group、ungroup、alt-text 等命令定义于 internal/cmd/slides_element.go。典型使用场景清理演示文稿中不再需要的占位元素形状、线条、文本框删除临时创建的装饰元素恢复幻灯片原始版式在自动化流水线中按 objectId 清单批量清理页面元素配合--dry-run预演删除效果确认 objectId 无误后再真正执行。用法与参数gog slides (slide) element delete (rm) presentationId objectId ...位置参数说明参数类型说明presentationIdstringGoogle Slides 演示文稿 ID必填objectId ...string[]一个或多个页面元素对象 ID必填至少 1 个命令支持同时删除多个元素在 presentationId 之后依次列出多个 objectId 即可例如同时删除gogShapeA、gogShapeB和gogLineA三个元素。输出与退出默认文本模式下执行成功后输出一行提示例如Deleted 3 elements单个元素时输出Deleted element objectId使用--json时输出结构化结果多元素场景输出{presentationId: ..., objectIds: [...], deleted: true}单元素场景输出{presentationId: ..., objectId: ..., deleted: true}使用--plain/--tsv时输出稳定、可解析的纯文本无颜色。全部标志位Flags以下标志表直接来自命令的运行时 schema由gog schema --json生成见 docs/commands/README.mdFlagTypeDefaultHelp--access-tokenstringUse provided access token directly (bypasses stored refresh tokens; token expires in ~1h)-a--account--acctstringAccount email, alias, or auto for authenticated Google API commands--clientstringOAuth client name (selects stored credentials token bucket)--colorstringautoColor output: auto|always|never--disable-commandsstringComma-separated list of disabled commands; dot paths allowed-n--dry-run--dryrun--noop--previewboolDo not make changes; print intended actions and exit successfully--enable-commandsstringComma-separated list of enabled command prefixes; dot paths allowed (restricts CLI)--enable-commands-exactstringComma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children-y--force--assume-yes--yesboolSkip confirmations for destructive commands--gmail-no-sendboolfalseBlock Gmail send operations (agent safety)-h--helpkong.helpFlagShow context-sensitive help.--homestringOverride gogcli config/data/state/cache root (equivalent to GOG_HOME)-j--json--machineboolfalseOutput JSON to stdout (best for scripting)--no-input--non-interactive--noninteractiveboolNever prompt; fail instead (useful for CI)-p--plain--tsvboolfalseOutput stable, parseable text to stdout (TSV; no colors)--quota-projectstringGoogle Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC)--readonlyboolfalseBlock mutating API requests at runtime; auth add also requests read-only OAuth scopes--results-onlyboolIn JSON mode, emit only the primary result (drops envelope fields like nextPageToken)--select--pick--projectstringIn JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.-v--verboseboolEnable verbose logging--versionkong.VersionFlagPrint version and exit--wrap-untrustedboolfalseIn JSON/raw output, wrap fetched text fields in external untrusted-content markers实战示例1. 删除单个元素gog slides element delete 1ABC123xyz gogShapeA --force2. 批量删除多个元素gog slides element delete 1ABC123xyz gogShapeA gogShapeB gogLineA --force3. 使用rm别名gog slides element rm 1ABC123xyz gogShapeA --force4. 先预演dry-run确认后再执行# 仅打印将要执行的操作不真正删除 gog slides element delete 1ABC123xyz gogShapeA gogShapeB --dry-run # 确认无误后再真正执行 gog slides element delete 1ABC123xyz gogShapeA gogShapeB --force5. 脚本化JSON 输出gog slides element delete 1ABC123xyz gogShapeA --json输出示例{presentationId:1ABC123xyz,objectId:gogShapeA,deleted:true}底层实现原理1. 批量构造 DeleteObject 请求该命令的实现位于 internal/cmd/slides_element.go。核心逻辑是遍历所有传入的 objectId为每个元素生成一个独立的slides.DeleteObjectRequest并统一打包进一个BatchUpdatePresentationRequest最终通过一次Presentations.BatchUpdate调用完成全部删除见 internal/cmd/slides_element.gorequests : make([]*slides.Request, 0, len(objectIDs)) for _, objectID : range objectIDs { requests append(requests, slides.Request{DeleteObject: slides.DeleteObjectRequest{ObjectId: objectID}}) }这意味着多元素删除是单次 API 请求内的批量操作而非逐元素发起多次 HTTP 调用效率更高且在 Google Slides 的 batch update 语义下是原子的批量提交。2. 破坏性操作的确认机制SlidesElementDeleteCmd在其 mutation 描述中设置了Destructive字段描述将删除哪些元素、从哪个演示文稿删除。该字段触发 internal/cmd/confirm.go 中的dryRunAndConfirmDestructive流程若传入--force或-y/--assume-yes/--yes跳过交互确认直接执行若传入--no-input且未带--force命令直接失败适合 CI避免挂起等待输入否则交互式提示用户确认删除。单元素与多元素场景的确认文案不同单元素为delete element objectId from presentation presentationId多元素为delete elements ids... from presentation presentationId。3. dry-run 不创建 API 服务测试 internal/cmd/slides_element_test.go 验证了 dry-run 行为在--dry-run模式下slides service 根本不会被创建mock 工厂中t.Fatal(slides service should not be created during dry-run)命令只打印预期的slides.element.delete操作与请求体后成功退出。这保证了预演是零副作用的。4. 输入校验在构造请求前命令会通过slidesElementTargetsinternal/cmd/slides_element.go执行校验presentationId 不能为空每个 objectId 不能为空字符串objectId 不允许重复重复会报duplicate objectId ...至少需要 1 个 objectId。这些校验由测试 internal/cmd/slides_element_test.go 覆盖校验失败时返回退出码 2。与其他 slides element 命令的配合删除通常是元素生命周期create → style → transform → group → delete的收尾环节。live 集成测试 scripts/live-tests/slides.sh 完整演示了这一流程用gog slides element create-shape/create-line创建元素用style、transform、alt-text、z-order、group等命令调整元素用gog slides element ungroup拆分组最后用gog slides element delete ... --force依次删除线、形状 A、形状 B通过gog slides read-slide ... --detail --json验证删除后元素集合中已不再包含上述 objectId。该测试还说明一个关键事实删除组时如果组内仍有子元素Google Slides API 会递归删除整组及其后代元素因此 live 测试中先 ungroup 再逐个删除是为了验证 ungroup 本身而非 delete 的限制。安全与自动化建议先 dry-run 后执行删除不可逆Google Slides API 无回收站式的元素恢复务必先用--dry-run确认 objectId 清单CI 场景加--no-input与--force组合--force --no-input可保证流水线既不挂起等待输入也不会因缺少确认而失败用--json解析结果脚本中可通过 JSON 中的objectIds/objectId与deleted: true字段断言删除结果只读保护若担心误删可结合全局--readonly标志该标志会在运行时拦截所有 mutating API 请求objectId 来源可通过gog slides read-slide presentationId slideId --detail --json获取页面元素清单及其 objectId再构造删除命令。相关命令gog slides element — element 命令族总览create-shape、create-line、transform、style、z-order、group、ungroup、alt-text、deletegog slides — slides 命令族总览Command index — 全部命令索引补充阅读docs/slides-structure.md 深入讲解 gogcli 对 Slides 文档结构的建模页面、元素、表格层级与 objectId 语义有助于你更准确地定位要删除的元素。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
gogcligog slides element delete命令详解批量删除 Google Slides 页面元素【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcligog slides element delete是 gogcliGoogle Workspace in your terminal中用于删除 Google Slides 演示文稿页面元素形状、线条、图片、文本框、表格、组等的核心命令。它支持在一条命令中删除任意数量的页面元素并内置 dry-run 预演、破坏性操作确认、JSON 输出等安全与自动化机制。阅读本文后你将掌握该命令的完整用法、全部可用标志位、底层 Google Slides API 调用链以及如何结合脚本与 CI 安全地执行元素清理。命令概览与使用场景该命令的命令路径为gog slides element delete同时提供别名rm。它归属于 gog slides element 子命令族该族还包括 create-shape、create-line、transform、style、z-order、group、ungroup、alt-text 等命令定义于 internal/cmd/slides_element.go。典型使用场景清理演示文稿中不再需要的占位元素形状、线条、文本框删除临时创建的装饰元素恢复幻灯片原始版式在自动化流水线中按 objectId 清单批量清理页面元素配合--dry-run预演删除效果确认 objectId 无误后再真正执行。用法与参数gog slides (slide) element delete (rm) presentationId objectId ...位置参数说明参数类型说明presentationIdstringGoogle Slides 演示文稿 ID必填objectId ...string[]一个或多个页面元素对象 ID必填至少 1 个命令支持同时删除多个元素在 presentationId 之后依次列出多个 objectId 即可例如同时删除gogShapeA、gogShapeB和gogLineA三个元素。输出与退出默认文本模式下执行成功后输出一行提示例如Deleted 3 elements单个元素时输出Deleted element objectId使用--json时输出结构化结果多元素场景输出{presentationId: ..., objectIds: [...], deleted: true}单元素场景输出{presentationId: ..., objectId: ..., deleted: true}使用--plain/--tsv时输出稳定、可解析的纯文本无颜色。全部标志位Flags以下标志表直接来自命令的运行时 schema由gog schema --json生成见 docs/commands/README.mdFlagTypeDefaultHelp--access-tokenstringUse provided access token directly (bypasses stored refresh tokens; token expires in ~1h)-a--account--acctstringAccount email, alias, or auto for authenticated Google API commands--clientstringOAuth client name (selects stored credentials token bucket)--colorstringautoColor output: auto|always|never--disable-commandsstringComma-separated list of disabled commands; dot paths allowed-n--dry-run--dryrun--noop--previewboolDo not make changes; print intended actions and exit successfully--enable-commandsstringComma-separated list of enabled command prefixes; dot paths allowed (restricts CLI)--enable-commands-exactstringComma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children-y--force--assume-yes--yesboolSkip confirmations for destructive commands--gmail-no-sendboolfalseBlock Gmail send operations (agent safety)-h--helpkong.helpFlagShow context-sensitive help.--homestringOverride gogcli config/data/state/cache root (equivalent to GOG_HOME)-j--json--machineboolfalseOutput JSON to stdout (best for scripting)--no-input--non-interactive--noninteractiveboolNever prompt; fail instead (useful for CI)-p--plain--tsvboolfalseOutput stable, parseable text to stdout (TSV; no colors)--quota-projectstringGoogle Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC)--readonlyboolfalseBlock mutating API requests at runtime; auth add also requests read-only OAuth scopes--results-onlyboolIn JSON mode, emit only the primary result (drops envelope fields like nextPageToken)--select--pick--projectstringIn JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.-v--verboseboolEnable verbose logging--versionkong.VersionFlagPrint version and exit--wrap-untrustedboolfalseIn JSON/raw output, wrap fetched text fields in external untrusted-content markers实战示例1. 删除单个元素gog slides element delete 1ABC123xyz gogShapeA --force2. 批量删除多个元素gog slides element delete 1ABC123xyz gogShapeA gogShapeB gogLineA --force3. 使用rm别名gog slides element rm 1ABC123xyz gogShapeA --force4. 先预演dry-run确认后再执行# 仅打印将要执行的操作不真正删除 gog slides element delete 1ABC123xyz gogShapeA gogShapeB --dry-run # 确认无误后再真正执行 gog slides element delete 1ABC123xyz gogShapeA gogShapeB --force5. 脚本化JSON 输出gog slides element delete 1ABC123xyz gogShapeA --json输出示例{presentationId:1ABC123xyz,objectId:gogShapeA,deleted:true}底层实现原理1. 批量构造 DeleteObject 请求该命令的实现位于 internal/cmd/slides_element.go。核心逻辑是遍历所有传入的 objectId为每个元素生成一个独立的slides.DeleteObjectRequest并统一打包进一个BatchUpdatePresentationRequest最终通过一次Presentations.BatchUpdate调用完成全部删除见 internal/cmd/slides_element.gorequests : make([]*slides.Request, 0, len(objectIDs)) for _, objectID : range objectIDs { requests append(requests, slides.Request{DeleteObject: slides.DeleteObjectRequest{ObjectId: objectID}}) }这意味着多元素删除是单次 API 请求内的批量操作而非逐元素发起多次 HTTP 调用效率更高且在 Google Slides 的 batch update 语义下是原子的批量提交。2. 破坏性操作的确认机制SlidesElementDeleteCmd在其 mutation 描述中设置了Destructive字段描述将删除哪些元素、从哪个演示文稿删除。该字段触发 internal/cmd/confirm.go 中的dryRunAndConfirmDestructive流程若传入--force或-y/--assume-yes/--yes跳过交互确认直接执行若传入--no-input且未带--force命令直接失败适合 CI避免挂起等待输入否则交互式提示用户确认删除。单元素与多元素场景的确认文案不同单元素为delete element objectId from presentation presentationId多元素为delete elements ids... from presentation presentationId。3. dry-run 不创建 API 服务测试 internal/cmd/slides_element_test.go 验证了 dry-run 行为在--dry-run模式下slides service 根本不会被创建mock 工厂中t.Fatal(slides service should not be created during dry-run)命令只打印预期的slides.element.delete操作与请求体后成功退出。这保证了预演是零副作用的。4. 输入校验在构造请求前命令会通过slidesElementTargetsinternal/cmd/slides_element.go执行校验presentationId 不能为空每个 objectId 不能为空字符串objectId 不允许重复重复会报duplicate objectId ...至少需要 1 个 objectId。这些校验由测试 internal/cmd/slides_element_test.go 覆盖校验失败时返回退出码 2。与其他 slides element 命令的配合删除通常是元素生命周期create → style → transform → group → delete的收尾环节。live 集成测试 scripts/live-tests/slides.sh 完整演示了这一流程用gog slides element create-shape/create-line创建元素用style、transform、alt-text、z-order、group等命令调整元素用gog slides element ungroup拆分组最后用gog slides element delete ... --force依次删除线、形状 A、形状 B通过gog slides read-slide ... --detail --json验证删除后元素集合中已不再包含上述 objectId。该测试还说明一个关键事实删除组时如果组内仍有子元素Google Slides API 会递归删除整组及其后代元素因此 live 测试中先 ungroup 再逐个删除是为了验证 ungroup 本身而非 delete 的限制。安全与自动化建议先 dry-run 后执行删除不可逆Google Slides API 无回收站式的元素恢复务必先用--dry-run确认 objectId 清单CI 场景加--no-input与--force组合--force --no-input可保证流水线既不挂起等待输入也不会因缺少确认而失败用--json解析结果脚本中可通过 JSON 中的objectIds/objectId与deleted: true字段断言删除结果只读保护若担心误删可结合全局--readonly标志该标志会在运行时拦截所有 mutating API 请求objectId 来源可通过gog slides read-slide presentationId slideId --detail --json获取页面元素清单及其 objectId再构造删除命令。相关命令gog slides element — element 命令族总览create-shape、create-line、transform、style、z-order、group、ungroup、alt-text、deletegog slides — slides 命令族总览Command index — 全部命令索引补充阅读docs/slides-structure.md 深入讲解 gogcli 对 Slides 文档结构的建模页面、元素、表格层级与 objectId 语义有助于你更准确地定位要删除的元素。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
