SuperAPI AI 工具集

ecommerce.amazon-ads-api-access

编程与开发

查看项目

更新于 10-16 01:36

技能介绍

用途:授权 Amazon Ads 账户,并检查安全的连接与配置文件(profile)元数据,用于在读取或变更前选择正确的广告账户。该授权流程独立于 Seller Central,不使用 Seller SP-API 连接器。

主要能力:保留 5 个 Amazon 平台操作,其中 4 个为读取或连接操作、1 个为变更操作。核心操作包括 authorize_url(POST /api/skill/amazon/connections/amazon-ads/authorize,需 region、marketplaceId,可选 workspaceId、accountName、returnPath)、authorized_stores(GET /api/skill/amazon/connections/amazon-ads,可选 workspaceId)、profiles(GET /api/skill/amazon/connections/amazon-ads/profiles,需 connectionId,可选 workspaceId)。refresh_token 与 store_tokens 为后端持有的令牌刷新与 OAuth 回调存储,已标记为不可调用。

使用方式:设置 NEXSCOPE_PROXY_BASE 为批准的网关地址,NEXSCOPE_API_KEY 为调用方凭证。使用 API key 解析出的 workspace(或显式 workspaceId)与自有 connectionId 选择账户。运行 scripts/amazon_connection.py,例如:python scripts/amazon_connection.py '{"action":"connections","workspaceId":"user:42"}';授权示例:python scripts/amazon_connection.py '{"action":"authorize","workspaceId":"user:42","region":"NA","marketplaceId":"ATVPDKIKX0DER","accountName":"Example account"}'。不要索取 Ads 访问令牌、刷新令牌、OAuth 客户端凭证或签名密钥。

适用场景:授权 Ads 并列出安全的配置文件或连接。不适用于管理广告活动或下载报告。

限制:旧版令牌存储与刷新命令不可调用,应改为检查连接状态;提供商速率限制因操作和账户而异,需遵守返回的速率限制元数据与 Retry-After,不要硬编码通用每秒请求数;网关仅允许特定 API 家族,不支持的路径属于契约错误,不得绕过网关;官方 API 名称与版本记录在 references/api.md,本包不包含直接外部主机 URL。不要请求、打印、缓存或存储提供商凭证,广告账户、活动、定向、指标与报告数据应视为私有。401/403 视为认证或所有权失败,429 为有界退避条件,5xx 为已净化的上游失败。计费或信用行为由网关契约决定。若凭证缺失或过期,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值信用。