SuperAPI AI 工具集

linkfox-amazon-ads-entity

设计与创作

查看项目

更新于 10-16 00:00

技能介绍

用途:管理 Amazon Ads 基础实体,支持 list(查询)与 create/update(创建、修改),覆盖 Sponsored Products (SP) v3、Sponsored Brands (SB) v4、Sponsored Display (SD) v3 三条产品线。SP 覆盖 campaigns、adGroups、keywords、negativeKeywords、productAds、targets 等;SB 覆盖 campaigns、adGroups、ads;SD 覆盖 campaigns、adGroups、productAds、targets、negativeTargets、creatives。

主要能力:自动分页(fetchAll 默认 true,SP/SB 用 nextToken,SD 用 startIndex+count,maxPages=50 兜底,超出标 truncated=true);对常见过滤器写法做兜底规范化;payload 透传 Amazon 原生格式。返回实体字段(id、名称、状态、匹配类型等),不含指标,指标需调 linkfox-amazon-ads-report 按 id join。

使用方式:依赖 linkfox-amazon-ads-auth,未安装时 exit 42。调用前必须解析数字 profileId:先经 ads-auth 的 authorized_stores.py 拉取已授权账号×站点清单,按站点匹配;单候选静默使用,多候选须用 accountName 向用户澄清,零候选引导授权;不得让用户直接报 profileId,也不得在歧义下选默认。共用参数含 profileId、region(NA/EU/FE)、fetchAll、maxResults、includeExtendedDataFields、locale。示例:python scripts/sp/list_campaigns.py '{"profileId":1234567890,"region":"NA","stateFilter":{"include":["ENABLED"]}}'。

适用场景:查询与批量创建/修改广告活动、广告组、关键词、定向、商品广告、创意与预算规则等。

限制:创建/更新会直接影响花费且不可撤回,未获授权时须先输出确认摘要;不支持 DELETE,归档需 update state 为 ARCHIVED 且不可逆;SB 的 keywords/targets 等无 list all;SD 按 id 单查、brandSafety、recommendations、forecasts、optimizationRules、locations 及 DSP/ST 实体均不在本技能范围。401 需刷新 token,403 核对 profileId,400 核对过滤器结构,429 等待 2-5s 重试。大响应可经 response_io.py 落盘后按字段读取,落盘文件可能含敏感数据,勿提交且用后清理。