用途:该技能面向 Spotify Ads API,用于对多条实体执行批量变更。默认将变更暂存为草稿(draft),按父级 campaign 分组并校验,绝不自动发布。
主要能力:支持的操作包括 pause(暂停多条活跃 ad set 或 campaign)、resume(恢复已暂停实体)、budget(批量更新预算,按设置金额、按百分比或按固定金额增减)、delivery(开关广告投放 ON/OFF)、archive(批量归档)、creative(跨广告替换创意素材)、tracking(更新第三方跟踪)。所有操作可选传入 campaign 过滤:pause --campaign <campaign_id>。
使用方式:先设置插件根目录并定义请求包装器:PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}";api() { "$PLUGIN_ROOT/scripts/api-request.sh" bulk "$@"; }。首次调用 Ads API v3 前需阅读并遵循 $PLUGIN_ROOT/skills/api-reference/references/live-openapi.md。可用 api --env 获取 TOKEN、AD_ACCOUNT_ID、AUTO_EXECUTE、BASE_URL 等设置,输出可安全 eval。流程为:列出候选实体、用户按编号/范围/all 选择、执行 ad 产品规则校验、展示变更摘要并确认、按父 campaign 分组暂存草稿(无草稿则先创建再 PATCH)、校验每个受影响 campaign,最后展示结果表。预算变更始终转换为 micro-amount(乘以 1,000,000)。
执行行为:auto_execute 为 true 时,用户确认摘要后暂存并校验;为 false 时逐条展示 curl 命令并确认。列表与选择步骤始终需要用户交互。出错时记录并继续处理其余实体,不自动重试 POST 或 PATCH。超过 50 个实体时显示前 50 个并建议用 --campaign 过滤。归档发布后不可撤销。仅当用户明确要求直接实时变更时才用已发布端点。
适用场景:需要对多条广告实体做一致化批量调整、创意替换或跟踪更新,并希望在发布前人工复核草稿的场合。
限制:该技能不会自动发布草稿,发布需在每次 PUBLISH 前单独明确确认;草稿可校验修改,但归档一旦发布即不可恢复。部分投放下限、冷却或账户豁免属于服务端检查,公开 API 不可见,不得声称已通过。资料未提供具体费用、价格或平台支持信息。