自2026年12月1日起(面向公共应用)及2027年1月1日起(面向自定义应用),所有受支持的管理API版本以及unstable均要求对废弃结账恢复URL中的四项受保护客户字段(姓名、电子邮件、电话和地址)进行审批。如果您的应用读取了AbandonedCheckout.abandonedCheckoutUrl或abandoned_checkout_url但并不需要这些数据,请停止使用该字段;如果确实需要,请在您的截止日期前申请访问权限。这是一项出于安全原因而进行的破坏性变更。
哪些应用以及何时
| 应用 | 日期 | 如何获取访问权限 |
|---|---|---|
| 公开应用 | 2026年12月1日 | 申请访问权限;需要进行数据保护审查 |
| 合作伙伴自定义应用(由合作伙伴为特定商店构建的应用) | 2027年1月1日 | 在 Dev Dashboard 中自行启用这四个字段;无需审核 |
| 在开发者仪表板中由商家创建的应用(商店或组织为其自身使用而构建的应用) | 2027年1月1日 | 在 Dev Dashboard 中自行启用这四个字段;无需审核 |
| 在 Shopify 管理后台创建的应用 | 不受影响 | 无需操作 |
原因
恢复 URL 会打开买家的结账页面,并自动填写其姓名、电子邮件、电话和地址。那些无法访问这些字段的应用程序已经无法读取 Abandoned Checkout 对象上的这些数据,因此该 URL 现在需要相同的访问权限。 AbandonedCheckout 因此,该 URL 现在需要相同的访问权限。
如果您未在截止日期前采取行动,会发生什么
以下情况适用于未获得全部四项受保护客户字段(姓名、电子邮件、电话和地址)read_customer_name, read_customer_email, read_customer_phone, 和 read_customer_address访问权限批准的应用:仅获得其中部分字段的批准是不够的。已获得全部四项字段批准的应用不受影响。
GraphQL Admin API:选择该字段的查询失败
- abandonedCheckoutUrl将返回ACCESS_DENIED错误,并且该错误会使周围的数据变为空值。
- 诸如abandonedCheckouts之类的列表查询将返回data: null,导致您在该查询中丢失所有废弃结账数据,而不仅仅是URL。
- 对某次结账执行node或nodes查找操作时,将返回null。
- 重试几分钟后,选择该字段的批量操作将以ACCESS_DENIED失败告终。
建议措施:从您的查询和批量操作中移除abandonedCheckoutUrl,或者申请访问权限。
# Before { abandonedCheckouts(first: 10) { edges { node { id abandonedCheckoutUrl } } } } # After { abandonedCheckouts(first: 10) { edges { node { id } } } }REST Admin API 和 webhooks:该字段被省略
警告:如果您的应用使用了abandoned_checkout_url,它将不再存在。从您的截止日期起,对于没有访问权限的应用,该字段将从REST响应和网络钩子有效载荷中移除。由于不会报错,您的应用不会得知该字段缺失。
- abandoned_checkout_url被排除在GET /admin/api/{version}/checkouts.json响应以及checkouts/create / checkouts/update网络钩子有效载荷之外。其余内容保持不变。
- REST 默认返回此字段,因此您的应用今天可能会收到它但未使用。如果您的应用从未读取它,您将不会注意到此更改。
- 如果您的应用读取了它,使用该 URL 的功能(如恢复电子邮件、短信或直接邮件)将失去链接,且假设该键存在的代码可能会失败。
建议措施:如果您的应用使用该URL,请在您的截止日期前申请访问权限。否则,请确保您的应用能够处理该字段缺失的情况。您也可以通过使用fields参数仅请求您使用的字段来停止接收它。
如何获取访问权限
如果您的应用需要恢复URL(例如用于发送废弃结账恢复消息),请申请受保护客户数据的访问权限:在开发者仪表板中,进入应用的设置 > 访问请求 > 受保护客户数据 > 管理,然后选择姓名、电子邮件、电话和地址字段并说明理由。必须同时申请全部四个字段。
- 自定义应用(包括合作伙伴自定义应用和在开发者仪表板中由商家创建的应用)可自行启用这些字段,无需审查。
- 公共应用在获得访问权限之前需要进行数据保护审查。审查可能需要几周时间,因此请尽早申请访问权限。
开发商店不强制执行受保护客户数据的审批,因此您在那里不会看到这些错误。请在 Dev Dashboard 中检查应用的受保护客户数据状态。
相关文档
- 处理受保护的客户数据
- 申请受保护客户数据的访问权限
- AbandonedCheckout 对象

