用途
Google Ads Apply 用于在 Google Ads 账户中执行已经过审核批准的草稿操作。它面向需要安全、可审计、可撤销地修改 Google Ads 账户的运营人员，通过命令行流程完成从草稿解析、校验、干跑、确认、执行到验证和审计的完整闭环。
主要能力
支持的操作类型（v1 + v2 预算）：
- 添加广告系列级否定关键词（Campaign criterion，低风险）
- 添加广告组级否定关键词（Ad group criterion，低风险）
- 暂停关键词（将状态设为 PAUSED，低风险）
- 暂停广告组（将状态设为 PAUSED，中风险）
- 设置广告系列每日预算（更新 amount_micros，中风险，需草稿包含 Apply Manifest）
这些操作被认为安全的原因：否定关键词只能减少流量，不会增加花费、破坏广告或损坏追踪；暂停关键词或广告组会停止对应流量，但保留全部历史、质量得分和配置；所有操作均可即时撤销（移除否定关键词或将状态改回 ENABLED）。
明确阻止的操作（硬拒绝）：
- 出价策略变更（v2，可能干扰智能出价学习）
- 广告系列创建（v3，影响范围大）
- RSA 修改（v4，影响学习期）
- 启用已暂停实体（v1 从不支持，风险高于暂停）
- 删除任何内容（一律不支持，改用暂停）
如果草稿包含范围外操作，apply 命令会列出这些操作、解释原因，并仅提供应用范围内操作的选项，无论是否确认都不会执行范围外操作。
使用方式
命令：
/google-ads apply [draft-file]— 应用草稿：读取草稿、解析操作、校验、通过 GAQL 解析资源 ID、展示干跑、等待操作员输入 "confirm" 或 "cancel"、通过 Google Ads REST API v20 执行、GAQL 重新查询验证、写入审计追踪、更新草稿状态为 "applied"、显示撤销说明。/google-ads apply review [draft-file]或/google-ads apply review --all— 仅审查草稿，不应用，纯本地分析，无网络调用。/google-ads apply status— 查看连接状态、待处理草稿、活跃撤销记录、最近应用会话和建议下一步。/google-ads undo [reversal-id]— 撤销单个操作，若变更已生效超过 7 天会发出警告。/google-ads undo-draft [draft-file]— 撤销某个草稿的全部活跃操作。/google-ads apply log— 查看最近应用会话日志。
CLI 脚本位于 scripts/apply-layer/：
gads-apply.sh— 完整应用流程gads-apply.sh --dry-run— 仅解析并展示干跑gads-apply.sh --parse-only— 解析草稿为 JSON（调试用）gads-review.sh/gads-review.sh --all— 审查草稿gads-undo.sh <rev-id>/gads-undo.sh --draft <file>/gads-undo.sh --list— 撤销操作gads-status.sh/--applied/--pending— 状态概览gads-smoke-test.sh <customer_id>— 端到端写入周期测试
草稿模板：
drafts/templates/negative-draft.md— 否定关键词添加、移除和收窄drafts/templates/pause-draft.md— 关键词暂停、广告组暂停和影响摘要
预算草稿必须包含 ## Apply Manifest，清单在存在时具有权威性；草稿级 meta.budget_policy 控制是否允许净增加。
校验与安全规则
执行前校验：账户匹配、广告系列存在、广告组存在、无重复否定关键词、匹配类型有效（仅 PHRASE、EXACT、BROAD）、暂停目标存在且当前为 ENABLED、广告组暂停目标当前为 ENABLED、操作在支持范围内。校验失败会报告失败项和原因，但不阻止整个应用，有效操作可继续。
安全规则：
- 无干跑不应用，操作员必须看到确切变更内容
- 不自动批准，必须显式输入 "confirm"
- 不应用范围外操作，硬拒绝并给出清晰解释
- 不删除任何内容，暂停是 v1 的最高严重级别
- 记录一切：每个操作、每个错误、每次撤销
- 优雅失败：一个操作失败时继续其余操作并报告
- 应用后验证：重新查询确认变更生效
- 便于撤销：每个操作都存储撤销指令
- 速率限制：每次会话最多 50 次变更，变更间隔 500ms
- 不跨账户批量应用：每次会话仅一个账户
审计追踪
每次应用会话后更新：主日志 workspace/ads/audit-trail/_log.md、会话详情 workspace/ads/audit-trail/YYYY-MM-DD-apply-session.md、撤销注册表 workspace/ads/audit-trail/reversal-registry.json、草稿文件（更新应用日期和撤销 ID）、草稿索引 workspace/ads/drafts/_index.md、变更日志 workspace/ads/change-log.md。
适用场景
适用于需要安全、可审计、可撤销地修改 Google Ads 账户的运营人员，尤其是添加否定关键词、暂停关键词或广告组、调整每日预算等低至中风险操作。
限制
- 仅支持上述四类变更加预算写入，其他操作硬拒绝
- 每次会话最多 50 次变更，变更间隔 500ms
- 每次会话仅限一个账户
- 预算草稿必须包含 Apply Manifest
- 撤销已生效超过 7 天的变更会发出警告
- API v20 已确认可用（2026-03-15），v18 已停用（404），v19 不稳定（500）
- 其他功能、收费、价格、平台或效果信息暂未提供