跳至正文
跨境独立站开店
资讯

2021 年更新记录 · 工具与应用 · Shopify API 版本发布:十月版

本文概述了截至 2021 年 10 月的 API 功能。本文解释了 Storefront API 的重大改进,包括改进后的购物车 API 以及通过 ID 检索特定资源的功能。

查看适用于你所在地区的 Shopify 注册优惠查看当前优惠

开发者必读!我们汇总了 2021 年 10 月更新的 API 功能。本文详细介绍了 Storefront API 的重大改进,包括改进后的购物车 API 以及通过 ID 检索特定资源的功能。

欢迎阅读 2021 年 10 月 API 功能发布概要。本页面提供的信息将帮助您应用最新变更,从而提升应用质量并简化开发环境。

此版本对 Storefront API 进行了重大改进,例如重新设计的购物车 API 以及通过 ID 检索特定资源的功能。此外,它还包含批量操作 Webhook、用于更轻松地管理预购订单的手动发货暂缓功能以及其他功能,并新增了短信营销许可端点,用于表明客户同意接收短信营销信息。

本次发布将移除 2020-10 版本。请务必检查您的 API 健康报告并查看未来的变更,以确保兼容性。有关此版本 API 变更的完整列表,请参阅 2021-10 版本说明(英文版)。

为 Shopify 商家开发一款应用

登记

1 购物车 API

此前,使用 Storefront API 管理购物车存在诸多重大障碍。获取实时产品库存、价格、折扣等信息的唯一方法是创建或更新结账页面。Shopify 严格限制结账次数,以维持良好的客户体验。管理这种“虚拟购物车”的请求也会计入结账次数限制。

在 2021-10 版本中,现在可以使用 Storefront API 直接与购物车进行交互。此购物车 API 显著提升了易用性,允许您检索有关下一个订单的所有上下文信息,而无需客户创建结账页面,直到他们准备付款为止。此外,这些购物车不受结账限流的限制;相反,它们与其他 Storefront 请求一样,受到相同的限流机制约束。限时抢购活动将极大地受益于此更新。现在,使用 Storefront API 创建的购物车可以使用结账队列。

以下是一个使用 Storefront API 创建购物车的 mutation 示例。

变量:

然后,API 返回一条购物车数据记录。

有关如何使用 Storefront API 管理购物车的详细信息,请参阅文档(英文版)。

2. 对 Storefront API 的改进

QueryRoot 新增了一个字段,使检索单个资源更加便捷。例如,现在可以直接通过 ID 或句柄查询博客、集合、页面和产品。该字段让您可以快速高效地检索所需资源。您不再需要搜索索引返回的所有资源列表,也不需要使用搜索端点来遍历 GraphQL 响应中每个资源的边和节点。

以下是一个 GraphQL 查询示例,该查询从产品的句柄中检索单个产品。

以下是回复:

3 批量操作 Webhook

在之前的版本中,您需要轮询批量操作的状态才能知道 Shopify 何时完成处理。2021 年 10 月发布的版本新增了一个 Webhook,用于通知客户批量操作的完成、失败或取消情况。该 Webhook 进一步降低了批量操作对 API 调用次数限制的影响,您只需等待包含批量操作状态的 Webhook 响应即可。无需再进行轮询!

以下是创建批量操作 Webhooks 订阅的 mutation 示例。

以下是批量操作完成后将发送到特定 URL 的有效负载示例。

有关更多详细信息,请参阅使用 GraphQL Admin API 执行批量操作的文档(英文版)。

4 人工履行暂缓

2021-10 版本新增了对订单履行流程的支持,使使用订单履行流程的客户的订单履行体验更加强大。订单履行流程现在支持“暂缓”操作,允许应用程序在缺货订单和预购订单等商品可供履行之前,暂缓其履行。

以下是一个将履行顺序设置为保持的变更示例。

变量:

以下是回复:

这些新操作将通过“履行订单”而非传统的履行平台实现。我们强烈建议执行履行操作的客户使用“履行订单”,而不是传统的“订单履行端点”。

5. 短信同意

API客户端现在可以获取、添加和更新客户通过短信接收营销材料的许可。更新此设置会触发CUSTOMERS_MARKETING_CONSENT_UPDATE webhook,确保您始终掌握客户营销偏好的最新信息。

这些设置由 customerSmsMarketingConsentUpdate 变更进行更新。示例如下所示。

以下是变量:

以下是回复:

再次提醒:所有开展营销活动的应用程序都必须在 Shopify 中更新客户记录,确保其中包含从客户处收集到的营销设置。在 Shopify 中保持客户营销设置信息的更新,可确保您商店中的所有应用程序都能尊重每位客户的个性化营销设置。

有关可用营销状态和选择加入级别的更多信息,请参阅 customerSmsMarketingConsentUpdate 变更文档。

定期检查是否有变化。

原文作者:Shayne Parmelee,译者:Nozomi Fukatsu

分享这篇文章

  • 在 Facebook 上分享
  • 分享至 X
  • 在领英上分享

相关内容

查看全部
工具与应用

工具与应用 · ShareASale跨境卖家注册及入驻指南

本教程将指导跨境卖家如何注册并加入 ShareASale 联盟平台,共包含 12 个步骤,包括填写有效的联系信息、设置 ShareASale 商家愿意支付的佣金率、设置跟踪有效期和货币单位、设置联盟管理规则、设置跟踪代码、测试跟踪代码以及支付 ShareASale 会员费和佣金。

注册优惠
Shopify

免费注册,查看开店优惠

前往 Shopify 查看你所在地区的试用期限、适用方案和优惠条件。

免费注册 Shopify推广链接说明