SuperAPI AI 工具集

clone

营销与增长

查看项目

更新于 10-16 09:30

技能介绍

用途:该技能通过读取已有广告系列的完整层级,并将其重建为草稿,实现广告系列或广告组的克隆。默认不会自动发布,需用户明确确认后才会执行。若目标是编辑而非复制现有广告系列,应改用 /spotify-ads-api:drafts stage-edit campaign <campaign_id> <changes>。

主要能力:

  • 克隆完整广告系列层级(广告系列+广告组+广告)。
  • 将单个广告组及其广告克隆到现有或新建广告系列中。
  • 克隆时可统一修改名称、日期、预算和定向。
  • 默认跳过 ARCHIVED 或 REJECTED 的广告。
  • 在创建前进行日期、资产、预算类型和受众估算等校验。
  • 创建后对草稿层级执行 VALIDATE,并输出克隆摘要。

必要用法: 设置插件根目录并定义请求包装: PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}" api() { "$PLUGIN_ROOT/scripts/api-request.sh" clone "$@"; }

首次调用 Ads API v3 前,需阅读并遵循 $PLUGIN_ROOT/skills/api-reference/references/live-openapi.md。获取设置值可运行 api --env,输出可用 eval 赋值。

参数解析: campaign <campaign_id> 克隆完整广告系列层级; ad-set <ad_set_id> 将单个广告组及其广告克隆进现有广告系列; 无参数时提示用户选择要克隆的实体。

限制:

  • 克隆不会自动发布,发布是单独操作且需在 PUBLISH 前明确确认。
  • 若广告系列创建失败则整体停止,无法继续创建广告组和广告。
  • 广告组创建失败会跳过其广告但继续其余广告组;广告创建失败会继续其余广告。
  • 不得自动重试 POST 请求。
  • 源日期已过且用户未修改日期时,克隆将失败。
  • 受众估算不满足最低门槛时,不应自行放宽定向,需询问用户。
  • 定向修改统一应用于所有广告组,单广告组更细粒度修改建议单独克隆。
  • 素材需存在且为 READY 状态,否则需警告并询问跳过或替换。
  • 仅当用户明确要求直接克隆为真实实体时才使用已发布创建端点。

适用场景:需要复制现有 Spotify Ads 广告系列结构作为新草稿进行调整时使用。相关操作:无现有广告系列可用 /spotify-ads-api:build-campaign 创建;克隆后可用 /spotify-ads-api:dashboard 或 /spotify-ads-api:monitor 监控;素材问题可用 /spotify-ads-api:assets list 或 /spotify-ads-api:assets upload 处理。