用途:该技能包面向 Amazon Ads(亚马逊广告),用于授权广告账户、管理 Sponsored Products(SP)、Sponsored Brands(SB)、Sponsored Display(SD)实体,并获取广告报表。注意 Amazon Ads 使用独立的 Advertising API 与授权服务,而非 Seller SP-API,此处的 SP 指 Sponsored Products。
主要能力:共保留 67 项 Amazon 平台操作,其中 23 项为读取或连接操作,44 项为写入操作。连接与授权类包括 authorize_url、authorized_stores、profiles;实体管理覆盖 SP、SB、SD 的广告活动、广告组、广告、预算规则、创意、商品广告、定向与否定定向的创建、更新与列表查询;报表方面支持 v3 reporting。
使用方式:仅使用 NEXSCOPE_PROXY_BASE 和 NEXSCOPE_API_KEY 两个配置项。提供方凭证、令牌刷新、请求签名、授权状态、上传位置与文档位置均保留在后端。聚合目录将连接与报表操作路由到专用脚本,普通实体操作走通用客户端。写入操作采用两阶段网关:先 POST /api/skill/amazon/ads/write-preview,再 POST /api/skill/amazon/ads/write-confirm;读取走 POST /api/skill/amazon/ads/read。多数实体操作需 connectionId,写入还需 payload,可选 workspaceId、queryString、requestId。
限制与注意:ads_auth.refresh_token 与 ads_auth.store_tokens 为后端托管,执行方式标记为 removed,不应由前端调用,应改用授权状态与连接元数据。SP v3 的 POST /list 请求需把过滤器放在请求体中,campaignIdFilter 与 stateFilter 使用含非空 include 字符串数组的对象,而非裸数组或 queryString。完整请求、校验、分页、结果与示例见 references/api.md,机器可读契约见 references/api.json。