大数跨境

abandonedCheckoutUrl 现在需要二级受保护的顾客数据访问权限

abandonedCheckoutUrl 现在需要二级受保护的顾客数据访问权限 Shopify电商独立站
2026-11-19
0
导读:自2026年12月1日起(面向公共应用)和2027年1月1日起(面向自定义应用),弃单恢复URL需对所有受支持的管理员API版本及不稳定版本中的全部四个受保护的顾客字段(姓名、电子邮件、电话和地址)进

自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 对象
【声明】内容源于网络
0
0
Shopify电商独立站
Shopify 是全球首屈一指的商务操作系统,致力于服务来自世界各地的数百万中小商户、大型零售贸易企业和国际知名品牌;其完善的软硬件及产品生态帮助用户简单便捷地,通过线上线下的多种渠道管理并销售自己的商品。
内容 7252
粉丝 1
Shopify电商独立站 Shopify 是全球首屈一指的商务操作系统,致力于服务来自世界各地的数百万中小商户、大型零售贸易企业和国际知名品牌;其完善的软硬件及产品生态帮助用户简单便捷地,通过线上线下的多种渠道管理并销售自己的商品。
总阅读127.3k
粉丝1
内容7.3k