ecommerce-amazon-ads-api-access

用途：授权 Amazon Ads 账户，并查看安全的连接与配置文件（profiles）元数据，用于在读取或变更前选择正确的广告账户。该授权流程与 Seller Central / SP-API 连接器相互独立。\n\n主要能力：包含 5 个 Amazon 平台操作，其中 4 个为读取或连接类操作、1 个为变更类操作。可用操作：authorize_url（POST /api/skill/amazon/connections/amazon-ads/authorize，需 region、marketplaceId，可选 workspaceId、accountName、returnPath）、authorized_stores（GET 同路径，读取）、profiles（GET /profiles，需 connectionId）。refresh_token 与 store_tokens 为后端托管，已标记移除、不可调用。\n\n使用方式：设置 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY。workspaceId 可选，若 API key 已绑定工作区可省略。请求需提供自有 connectionId 及目标账户、市场、区域。调用示例：\npython scripts/amazon_connection.py '{"action":"connections","workspaceId":"user:42"}'\npython scripts/amazon_connection.py '{"action":"authorize","workspaceId":"user:42","region":"NA","marketplaceId":"ATVPDKIKX0DER","accountName":"Example account"}'\n分页读取仅在 fetchAll 为 true 时跟随 continuation token，并在 maxPages 截止，返回 success、pagesFetched、truncated、total 等元数据；客户端 ASIN/SKU 过滤会额外报告 serverTotalBeforeClientFilter 与 clientSideFilters。\n\n限制：不要求也不应提供 Ads 访问令牌、刷新令牌、OAuth 客户端凭证或签名密钥；令牌存储与刷新由后端负责。旧版令牌存储/刷新命令不可调用，应改为查看连接状态。不支持管理广告活动或下载报表，此类请求需选用包含对应操作的更窄或聚合包。Provider 速率限制因操作与账户而异，需遵守返回的限流元数据与 Retry-After。401/403 视为认证或归属失败，429 为有限退避，5xx 为上游失败。官方 API 名称与版本见 references/api.md，本包不含直接外部主机 URL。