Ads API 申请第 5 步:365 天重新授权与错误排查
从 2026-07-30 起,Ads API 的 Refresh Token 不再长期有效:自你点 Allow 那天起 365 天到期,用得再勤也不会顺延。到期那天,系统读不到报告、也调不了出价。
到期前重新授权,并更新到中转客户端(可点击任一步)
日期均为示意。重新授权的操作与第 3 步相同。
Ads API Refresh Token 到期前怎么重新授权?
记下到期日
你的日历2026-07-30 当天及以后签发的 refresh token,自广告主同意之日起 365 天到期;到期日在同意时确定,不因使用而延长 [1]。官方建议监控 token 年龄,在到期前提醒重新授权 [1]。
琼仁智度不会替你续期授权。每次授权后,把到期日写进你和运营负责人的日历,并提前安排有广告权限的账号操作。
重新走一遍授权
www.amazon.com/ap/oa → Allow → 复制 code操作与 第 3 步 完全相同:打开北美授权链接、用有广告权限的账号点 Allow、从地址栏复制授权码。授权码 5 分钟内有效且只能用一次 [5]。
换取新的 Refresh Token
你的电脑 → Windows PowerShell用 grant_type=authorization_code 换取新的 access token 与 refresh token [6],完整复制以 Atzr| 开头的新 refresh token。
更新到中转客户端
中转客户端 · 本机设置页只替换 Ads API 的 Refresh Token;Client ID、Client Secret、Profile ID 不变。然后在日历里记下新的到期日。
Amazon Ads API 常见错误怎么排查?
| 错误 | 官方含义 | 怎么处理 |
|---|---|---|
| 刷新时 400 invalid_grant | refresh token 已失效:到期、撤销、移除应用、凭证被改或可疑活动 [1] | 重新授权并更新 Refresh Token |
| 401 Unauthorized | 缺少 Scope 头、profile 与广告主不匹配或无权访问该 scope [7] | 核对 Profile ID 与请求头;检查授权账号权限 [8] |
| 403 Forbidden | 无权访问指定资源 [7] | 检查授权账号在卖家中心的广告相关权限 |
| 429 Too Many Requests | 被限流,响应带 Retry-After;限流随系统负载动态调整 [9] | 按 Retry-After 等待,再指数退避重试 |
| 5xx | 服务端错误 [9] | 指数退避重试,持续不恢复再上报 |
接入问题可发邮件至 ads-api-onboarding@amazon.com,持续支持为 ads-api-support@amazon.com [10]。
重新授权由谁来做?
由你本人用有广告权限的账号完成。数据政策要求应用每 365 天重新取得用户同意 [3]——这份同意来自你,也只应由你给出。
凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请,Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码,也不得索取他人的访问密钥 [11][3]。琼仁智度的设计是:凭证只录入你电脑上的中转客户端并加密保存在本机,云端从不接收、从不存储;所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。
Ads API 系列已完成
授权保持有效,琼仁智度就能持续帮你做什么?
有了 Ads API 凭证与 Profile ID,PPCWISER 琼仁智度就能读取你的搜索词、版位与广告报告,并在利润约束内调整出价与关键词:
- 按关键词 × 时段 × 版位分配出价——见 168 时段分时出价、版位溢价自动反推
- 先保护、再否定的自动否词;稳定出单的搜索词自动提取为精准投放——见 自动否定词、自动提取精准词
- 出价、版位溢价与分时规则同一轮下发,每次调价都有可读的原因——见 三合一安全下发
小时级的流量与转化来自 Amazon Marketing Stream,需要你用自己的 AWS 账号接收 [12],见 AWS 与 Marketing Stream 教程。算法按统一的广告结构运行,接入时二选一:重构现有系列(方案 A)或保留原系列另建标准结构(方案 B),见 广告结构说明。不想自己摸索?API 申请协助(¥499/次):你本人操作,我们远程指导。
Ads API 重新授权常见问题
Ads API 的 Refresh Token 到期后,广告会停吗?
2026-07-30 以前拿到的 Refresh Token 会过期吗?
重新授权要重新申请 Ads API 吗?
重置了 Client Secret 会怎样?
凭证准备好,就可以开始 30 天免费试用
全部功能开放,试用期不收订阅费;之后入门版 ¥99/月/店铺(含 10 个产品),每多 1 个产品 +¥10/月。API 不想自己摸索?申请协助 ¥499/次,你本人操作、我们远程指导。
相关功能
Ads API 申请
Ads API 申请 5 步:安全配置文件、申请分配、授权换 Token、Profile ID、365 天续期。
查看 →SP-APISP-API 申请
SP-API 私有应用申请 5 步:准备、注册验证、开发者资料、建应用自授权、轮换。
查看 →接入教程安装中转客户端
Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。
查看 →控制权总开关在你手里
停中转即断开,中转身份可吊销,协议留痕,亚马逊侧可直接撤销。
查看 →服务API 申请协助
¥499/次:你本人操作,我们远程指导 SP-API 与 Ads API 申请。
查看 →参考资料与权威来源
本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。
- [1]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期,到期日不因使用而延长,到期后须重新授权;撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant;建议加密保存并在到期前提醒重新授权。
- [2]官方Amazon Ads API Release notes — Amazon Ads API Docs · 20262026-05-26 公告:自 2026-07-30 起签发的 refresh token 365 天到期;2025-12-01 统一的 Campaign Management API 全球正式发布。
- [3]官方Data Protection Policy / Acceptable Use Policy(Amazon Ads API) — Amazon Ads · 2026Ads API 数据政策:切勿共享密钥或密码,切勿出于任何目的索要或接受广告参与者的访问凭证,不申请用不到的访问,应用须每 365 天重新取得用户同意,发现安全事件 24 小时内报告。
- [4]官方Manage third-party apps & services with data access through Login with Amazon — Amazon Customer Service · 2026Amazon 账户持有人可在 Your Account → Manage your data → Manage apps & services with data access 中移除已授权的应用。
- [5]官方Getting started - Create an authorization grant — Amazon Ads API Docs · 2026在 LwA 安全配置文件的 Web Settings 中设置 Allowed Return URLs(直接广告主可用 https://amazon.com 并手动复制授权码);北美授权地址前缀为 https://www.amazon.com/ap/oa;授权码 5 分钟内有效且只能使用一次;授权账号可以与开发者账号不同。
- [6]官方Step 2: Generate access and refresh tokens — Amazon Ads API Docs · 2026用授权码向 LwA token 端点 POST(grant_type=authorization_code、code、redirect_uri、client_id、client_secret)换取有效期 3600 秒的 access token 与 refresh token;Atza|、Atzr| 前缀是 token 的一部分。
- [7]官方Error responses and error status codes — Amazon Ads API Docs · 2026Ads API 错误说明:401 可能是缺少 Scope 请求头、profile 与广告主不匹配或无权访问该 scope;403 表示无权访问指定资源。
- [8]官方Permissions — Amazon Ads API Docs · 2026卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项;授权账号缺少对应权限时 API 返回 401。
- [9]官方Rate limiting — Amazon Ads API Docs · 2026请求过多时返回 429 并带 Retry-After 头,限流随系统负载动态调整,官方建议指数退避重试。
- [10]官方Support for Amazon Ads advanced tools — Amazon Ads API Docs · 2026Ads API 接入问题可发邮件至 ads-api-onboarding@amazon.com,持续支持为 ads-api-support@amazon.com。
- [11]官方Acceptable Use Policy(SP-API) — Amazon Seller Central · 2026SP-API AUP:2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途;提交给亚马逊的材料须准确;3.1 不得共享访问密钥或密码;3.2 不得出于任何目的索取或接收授权用户的访问密钥;3.3 不得索要卖家中心用户名密码;3.5 连续 90 天无成功调用的访问密钥会被删除;3.8 不得申请应用功能用不到的数据。
- [12]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。