服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 公共应用从 2026 年 12 月 1 日起适用,伙伴自定义应用和商家通过 Dev Dashboard 创建的应用从 2027 年 1 月 1 日起适用。
- GraphQL 选择恢复链接可能导致整个弃单列表失败。REST 和相关 webhook 会省略链接字段。
- 在 Dev Dashboard 核对四项权限,并用合成数据测试失败分支。开发店铺查询成功无法证明正式应用已获批。
查应用类型、字段依赖和生效日
Shopify 于 2026 年 11 月 19 日公告,读取弃单恢复链接需要姓名、邮箱、电话和地址四项受保护客户字段权限。新要求覆盖所有受支持的 Admin API 版本和 <code>unstable</code>。公共应用从 2026 年 12 月 1 日起受影响,需申请并通过数据保护审核。伙伴为指定店铺制作的自定义应用,以及商家在 Dev Dashboard 创建的自用应用,从 2027 年 1 月 1 日起受影响,可在面板自行开启四项权限。商家直接在 Shopify 后台创建的应用不受该变更影响。
先盘点应用实际读取的内容,包括 GraphQL 查询、批量任务、REST 解析和 webhook 消费者。只用弃单 ID、时间或状态做统计时,从 GraphQL 查询和批量任务去掉恢复链接。邮件、短信或其他触达流程确实需要该链接时,再为相应功能核对权限。
GraphQL 拒绝查询,REST 和 webhook 省略字段
对于未获全部四项权限的应用,GraphQL 读取 <code>abandonedCheckoutUrl</code> 会收到 <code>ACCESS_DENIED</code>。官方示例中,<code>abandonedCheckouts</code> 列表的整个 <code>data</code> 返回 <code>null</code>。通过 <code>node</code> 或 <code>nodes</code> 查询时,对应弃单返回空值。包含该字段的批量操作也会报权限错误。记录错误与操作名称,避免把权限错误当成没有弃单。
REST 的 <code>checkouts.json</code> 响应和 <code>checkouts/create</code>、<code>checkouts/update</code> webhook 会省略 <code>abandoned_checkout_url</code>,没有单独的缺失提示。消费者应先检查键是否存在。缺少链接时暂停依赖链接的动作,同时让可以独立处理的订单统计或状态流程继续运行。
在 Dev Dashboard 核对实际授权
需要链接时,从应用的 Settings 进入 Access requests,在 Protected customer data 的 Manage 区域核对姓名、邮箱、电话和地址。公共应用须按用途提交并获批。伙伴自定义应用和商家在 Dev Dashboard 创建的应用可按公告自行选择这些字段。已获其中几项的应用应核对剩余项目。普通 Admin API 访问范围的核对不能代替这一步。
开发验证可在选定分发方式后,为开发应用选择测试所需字段。Shopify 公告明确指出,开发店铺不执行这项权限限制。开发查询能返回链接时,仍需在正式应用的 Dev Dashboard 检查四项权限状态。
用合成响应验证失败时的行为
为 GraphQL 准备权限错误和 <code>data: null</code> 的合成响应,为 REST 与 webhook 准备没有链接键的合成数据。核对应用能记录权限问题、停止依赖链接的发送,并保留不需要链接的流程。检查日志与测试数据时使用模拟链接,避免复制包含客户资料的真实恢复链接。
资料来源
常见问题
把 Admin API 版本固定在旧版可以避开吗?
Shopify 公告覆盖所有受支持版本和 unstable。按应用类型核对生效日及四项权限。
只获批邮箱权限,能读取恢复链接吗?
需要姓名、邮箱、电话和地址四项。在 Dev Dashboard 检查每项状态。
开发店铺读到链接,正式店铺就一定能读到吗?
开发店铺不执行这项检查。请单独核对正式应用权限,并测试应用处理权限拒绝和字段缺失的分支。