用途:该技能包用于 Amazon Ads v3 报告的完整工作流,包括按内置报告类型目录构建配置,然后创建、轮询、恢复、下载、解码并可选保存报告。报告创建、轮询与下载均走 Amazon Advertising API 连接,不使用 Seller SP-API 连接。
主要能力:提供 get_report 操作(POST /reporting/reports,访问级别 write,执行方式 specialized),必填 connectionId,可选 workspaceId、reportId、reportTypeId、adProduct、groupBy、columns、name、startDate、endDate、timeUnit、format、filters、configuration、timeoutSeconds、pollIntervalSeconds、outputFile、overwrite 等。报告 ID 是持久恢复句柄;文档位置仅以短期不透明后端令牌表示。分页读取在 fetchAll 为 true 时跟随 continuation token,并在 maxPages 处停止,返回 success、pagesFetched、truncated、total 等元数据。
使用方式:设置 NEXSCOPE_PROXY_BASE 为批准的网关地址,设置 NEXSCOPE_API_KEY 为调用方凭证;使用 API key 解析出的 workspace(或显式 workspaceId)与自有 connectionId 选择账户。运行脚本:python scripts/amazon_ads_report_workflow.py '{...}'。示例参数含 workspaceId、connectionId、startDate、endDate、reportTypeId、adProduct、groupBy、columns。若返回 pending,需保存 reportId 以便恢复。
适用场景:创建、恢复或下载 Ads v3 报告。不适用于广告活动变更或 Seller 报告。
限制:报告创建可能返回重复报告恢复响应,需用返回的 reportId 恢复;不启动本地 HTTP 监听;下载位置以不透明令牌替代,outputFile 最多安全发布 20 MiB,除非显式 overwrite:true 否则拒绝覆盖;速率限制因操作与账户而异,需遵守返回的限流元数据与 Retry-After,不要硬编码固定 RPS;网关仅允许特定 API 家族,不支持的路径属于契约错误;401/403 视为认证或归属失败,429 为有界退避,5xx 为净化后的上游失败;Ads 报告 425 恢复仅适用于该工作流。不要请求、打印、缓存或存储提供商凭证。