您现在可以在 Shop SDK 潜在客户捕获过程中请求应用所需的具体配置文件数据，包括未保存在用户 Shop 配置文件中的详细信息。使用丰富授权请求（RAR）来选择哪些字段是必填的，哪些可以由用户跳过。现有集成无需更改即可继续正常工作；RAR 为可选功能。
变更内容
Lead capture 现在接受 authorizationDetails 属性。该属性采用序列化的 JSON 数组，列出应用所需的字段，并将每个字段标记为必填或可选。例如，此请求要求提供电话号码，并使出生日期变为可选：
const authorizationDetails = JSON.stringify([ { type: 'urn:shopify:shop_app:data-sharing:v1', datatypes: [ {name: 'phone_number', required: true}, {name: 'birthdate', required: false}, ], }, ]);你可以使用 RAR 请求名、姓、电话号码和出生日期。现有的 OAuth 作用域 shop_app:user:profile 和 shop_app:user:phone 分别允许你请求已有的姓名和电话号码，但不会提示用户提供缺失的值。
在用户授权你的应用之前，Shop 会询问他们是否已向你的应用共享任何请求的字段。用户必须提供必填字段的值，并可以跳过可选字段。如果用户拒绝授权你的应用，则即使该用户登录到商店，onComplete 中也不会包含 shopConsentToken。请将缺少 shopConsentToken> 视为预期结果进行处理。
受影响对象
此变更适用于使用 Shop SDK 潜在客户捕获的应用程序。要读取通过 RAR 请求的数据，您的应用程序需要客户端密钥和可信服务器。
与现有的潜在客户捕获方式一样，Shop 返回的已授权电话号码可以替换商店客户记录中的其他电话号码。现有姓名不会被替换。
操作指南
使用 RAR 请求数据：
- 在创建 lead capture 实例时，将序列化数组作为 attributes.authorizationDetails 传递。若要同时请求用户的标识符和电子邮件，请按照指南所示，将 attributes.scope 设置为 'shop_app:oauth'。
- 在 onComplete 中，当事件包含 shopConsentToken 时，将其发送到你的服务器。该事件不包含请求的数据。如果事件包含 customerUpdateErrors，则说明商店客户记录的更新失败。
- 从你的服务器出发，通过 Shop Partners API 上的 fetchTokensForUser 突变来交换同意令牌。从响应或 Shop Users API 中读取已授权字段，并对未授予或没有值的字段处理 null。
- 在发布之前，测试完整的授权、跳过的可选字段、被拒绝的授权，以及在 onError 中返回 invalid_authorization_details 的格式错误的 authorizationDetails JSON 请求。有关请求格式和错误处理，请参阅 lead capture guide。
相关文档
- 潜在客户捕获
- 获取 Shop 用户信息