SuperAPI AI 工具集

drafts

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:为 Spotify Ads API 提供默认的写入流程,把新建或修改的广告活动、广告组、广告先暂存为草稿,校验后再批量发布。草稿流是创建层级结构的首选方式,便于上线前审阅、批量校验、安全迭代和随时删除。

主要能力:支持 stage-edit(对已发布实体安全暂存修改)、build(按文本描述创建完整草稿层级)、list、get、edit、delete、validate、publish、draft-from 等操作。校验动作会一次性检查整个层级(活动+广告组+广告)并汇总错误;只有 VALIDATE 或 PUBLISH 时才强制必填字段,草稿允许部分字段缺失以便渐进式构建。

使用方式:先设置插件根目录与请求包装器,例如 PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}" 和 api() { "$PLUGIN_ROOT/scripts/api-request.sh" drafts "$@"; },首次调用 Ads API v3 前需阅读对应的 live-openapi.md。可通过 api --env 获取 TOKEN、AD_ACCOUNT_ID 等设置值。随后按操作解析参数、调用对应草稿端点。校验前需先获取活动草稿当前的 draft_hierarchy_version,再以该版本执行 VALIDATE;发布始终需要显式确认。

适用场景:创建或修改 Spotify 广告活动层级结构,需要先审阅再上线、批量校验、增量搭建或避免触碰线上实体的情形。

限制:资料仅覆盖 Spotify Ads API 草稿工作流,未提供收费标准、价格、平台依赖版本或效果数据;发布前必须校验,某些账号或凭据可能缺少直接创建的权限,草稿字段要求与发布时不同。