服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 功能面向采用 Shopify-managed installation 的应用。只影响调用方的当前安装。
- 候选权限须声明在 optional_scopes 中,是有对应读权限的写权限。必需权限不能降级。
- 一项权限验证失败会使整次请求被拒绝。已声明但当前未获准的有效写权限会被忽略。
- 测试前后可用 currentAppInstallation 核对当前实际获准权限。
什么情况下适合从写权限降为读权限?
Shopify 在 2026 年 10 月 7 日公告中说明,新操作供仍需读取、已不需要修改某类数据的应用使用。例如,店铺关闭商品编辑功能,但还要保留商品目录展示。如果该安装满足条件,可以把可选的 write_products 换为 read_products。
写权限本身包含相应读能力。若直接用 appRevokeAccessScopes 撤销写权限,而读取能力只来自该写权限,这部分读取能力也会被移除。需要继续读取时,先用候选版本验证降权操作。
调用前检查哪些条件?
确认采用 Shopify-managed installation,并且目标权限在应用配置的 optional_scopes 中。目标需是 Shopify 有对应读权限的写权限。列在 scopes 中的必需权限不能通过这个操作降级。
再查当前安装实际获准权限,别只看配置声明。使用 currentAppInstallation 核对目标安装及权限。可选权限是应用可以请求的范围,商家可能尚未批准。此次调用只改变实际调用的安装,其他店铺要分别评估。
一批权限里有一项不合格会怎样?
如果任何一项未通过验证,Shopify 会拒绝整个请求,该安装的权限保持原样。比如把有效的可选 write_products 和一个必需写权限一起提交,不能预期平台先处理前一项。先修正请求,再核对实际获准权限。
符合验证条件但当前未获准的写权限会被忽略。处理结果时,要区分哪些权限实际变化、哪些原本就不存在,再按安装记录更新你的权限视图。
怎样测试读取保留、写入停用?
在获授权的开发店铺用 2027-01 候选版验证。先记录当前安装权限并找出依赖该写权限的任务、后台作业和界面入口,再在测试安装中调用 appDowngradeAccessScopes。
随后查询实际权限,确认对应读权限仍可用,应用内依赖写权限的功能已按预期收起或停用。若商家后来要重新开启写入功能,可按现行可选权限流程请求商家授权。
后台写任务也需要单独验证。比如商品同步进程仍在执行写入时,先在测试安装停用该进程,再确认只读页面正常,避免界面隐藏后队列仍继续发送写入请求。
资料来源
常见问题
旧版本应用会在 2027 年 1 月 1 日自动降权吗?
Shopify 公告说现有应用无需采取操作。降权由符合条件的应用主动在当前安装调用。
能把任意写权限换成某个无关读权限吗?
这项操作只支持写权限及 Shopify 定义的对应读权限。调用前查现行访问权限定义。