PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
Ads API 申请教程 · 第 5 步 / 共 5 步

Ads API 申请第 5 步:365 天重新授权与错误排查

从 2026-07-30 起,Ads API 的 Refresh Token 不再长期有效:自你点 Allow 那天起 365 天到期,用得再勤也不会顺延。到期那天,系统读不到报告、也调不了出价。

30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
动画演示

到期前重新授权,并更新到中转客户端(可点击任一步)

日期均为示意。重新授权的操作与第 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 不变。然后在日历里记下新的到期日。

失效原因

Ads API Refresh Token 什么情况下会失效?

情形依据你要做的
到了 365 天期限(2026-07-30 起签发的)[1]重新授权,更新中转客户端
广告主撤销了授权或移除了应用[1][4]确认是否误操作;需要继续使用就重新授权
LwA 应用的凭证被修改或删除[1]不要随意重置 Client Secret;重置后需重新授权并更新
亚马逊检测到可疑活动[1]检查凭证是否外泄,处置后重新授权

以上情形下刷新 token 会返回 400 与 invalid_grant [1]。另外,Ads API 数据政策要求不共享密钥,发现安全事件 24 小时内报告 [3]。

错误排查

Amazon Ads API 常见错误怎么排查?

错误官方含义怎么处理
刷新时 400 invalid_grantrefresh 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]。

撤销授权

怎么撤销 Ads API 授权?

广告主可以在亚马逊账户中依次进入 Your Account → Manage your data → Manage apps & services with data access,在对应应用旁移除授权 [4]。撤销后,该应用的 refresh token 失效 [1]。

如果只是想暂停琼仁智度的操作,不需要撤销授权:停掉你电脑上的中转客户端,云端就立即无法通过它操作你的账户,见 总开关在你手里。

凭证归属

重新授权由谁来做?

由你本人用有广告权限的账号完成。数据政策要求应用每 365 天重新取得用户同意 [3]——这份同意来自你,也只应由你给出。

凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请,Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码,也不得索取他人的访问密钥 [11][3]。琼仁智度的设计是:凭证只录入你电脑上的中转客户端并加密保存在本机,云端从不接收、从不存储;所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。

拿到凭证之后

授权保持有效,琼仁智度就能持续帮你做什么?

有了 Ads API 凭证与 Profile ID,PPCWISER 琼仁智度就能读取你的搜索词、版位与广告报告,并在利润约束内调整出价与关键词:

小时级的流量与转化来自 Amazon Marketing Stream,需要你用自己的 AWS 账号接收 [12],见 AWS 与 Marketing Stream 教程。算法按统一的广告结构运行,接入时二选一:重构现有系列(方案 A)或保留原系列另建标准结构(方案 B),见 广告结构说明。不想自己摸索?API 申请协助(¥499/次):你本人操作,我们远程指导。

Ads API 重新授权常见问题

Ads API 的 Refresh Token 到期后,广告会停吗?
已经设置在亚马逊广告后台的出价、版位与分时规则不会因为 token 到期被清除;但系统无法再读取报告或做新的调整,直到你重新授权并更新凭证。请在日历中记下到期日。
2026-07-30 以前拿到的 Refresh Token 会过期吗?
官方说明 365 天到期只适用于 2026-07-30 及以后签发的 token,此前签发的不受这一项影响 [1];但撤销、移除应用、修改凭证等情形仍会使其失效。
重新授权要重新申请 Ads API 吗?
不需要。只要重新走一遍授权、换取新的 Refresh Token 即可 [5][6];Client ID、Client Secret 与 Profile ID 不变。
重置了 Client Secret 会怎样?
修改或删除 LwA 应用凭证会使该应用下的 refresh token 失效 [1]。重置后需要重新授权,并把新 Secret 与新 Refresh Token 都更新到中转客户端。
怎么确认 Refresh Token 还有效?
用它换取一次 access token:成功返回即有效;返回 invalid_grant 说明已失效 [1]。命令见 第 4 步。

凭证准备好,就可以开始 30 天免费试用

全部功能开放,试用期不收订阅费;之后入门版 ¥99/月/店铺(含 10 个产品),每多 1 个产品 +¥10/月。API 不想自己摸索?申请协助 ¥499/次,你本人操作、我们远程指导。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
继续了解

相关功能

Ads API

Ads API 申请

Ads API 申请 5 步:安全配置文件、申请分配、授权换 Token、Profile ID、365 天续期。

查看 →
SP-API

SP-API 申请

SP-API 私有应用申请 5 步:准备、注册验证、开发者资料、建应用自授权、轮换。

查看 →
接入教程

安装中转客户端

Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。

查看 →
控制权

总开关在你手里

停中转即断开,中转身份可吊销,协议留痕,亚马逊侧可直接撤销。

查看 →
服务

API 申请协助

¥499/次:你本人操作,我们远程指导 SP-API 与 Ads API 申请。

查看 →
REFERENCES

参考资料与权威来源

本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。

  1. [1]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期,到期日不因使用而延长,到期后须重新授权;撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant;建议加密保存并在到期前提醒重新授权。
  2. [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. [3]官方Data Protection Policy / Acceptable Use Policy(Amazon Ads API) — Amazon Ads · 2026Ads API 数据政策:切勿共享密钥或密码,切勿出于任何目的索要或接受广告参与者的访问凭证,不申请用不到的访问,应用须每 365 天重新取得用户同意,发现安全事件 24 小时内报告。
  4. [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. [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. [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. [7]官方Error responses and error status codes — Amazon Ads API Docs · 2026Ads API 错误说明:401 可能是缺少 Scope 请求头、profile 与广告主不匹配或无权访问该 scope;403 表示无权访问指定资源。
  8. [8]官方Permissions — Amazon Ads API Docs · 2026卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项;授权账号缺少对应权限时 API 返回 401。
  9. [9]官方Rate limiting — Amazon Ads API Docs · 2026请求过多时返回 429 并带 Retry-After 头,限流随系统负载动态调整,官方建议指数退避重试。
  10. [10]官方Support for Amazon Ads advanced tools — Amazon Ads API Docs · 2026Ads API 接入问题可发邮件至 ads-api-onboarding@amazon.com,持续支持为 ads-api-support@amazon.com。
  11. [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. [12]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。