Shopify API发布:2021年1月

欢迎来到2021年1月版的API功能综述，旨在帮助您了解如何采用所有最新更改来提高应用程序质量并简化开发体验。

在这个版本中，我们发布了最受欢迎的功能之一:通过我们的新版本对订阅的原生支持订阅api．这个版本还包含了一些功能的示例:为预付费订阅提供预定服务，自动激活应用程序收费，以及有关订单和交易的更详细的财务信息，如费用和小费总额。

2021-01的发布也恰逢2020-01版本的移除，所以记住检查您的API运行状况报告确保你们能合得来查看即将发生的更改．

在本文中，我们将介绍2021-01版本中包含的功能。

1.订阅api

这个版本包含了新的api在Shopify上订阅．这些新增功能允许合作伙伴和开发人员构建与结账集成的应用程序，极大地改善了提供订阅服务的商店的客户体验。订阅api在订单的整个生命周期中与Shopify完全集成，因此可以轻松提供准确的运费，允许应用折扣，然后通过Shopify管理和完成订单。

我们包含了几个新的端点和资源来帮助您代表商家管理订阅。销售计划是为产品组设置交付策略和计费策略(如“订阅和保存”)的灵活资源。当客户下的订单中包含有销售计划的产品时，开发人员可以进行管理订购合同方便随时随地的经常性付款客户付款方式是可用的。

订阅合同、订阅计费尝试和客户付款方法都收到了自己的webhook主题，因此您将始终能够与常见的订阅事件保持同步。

访问我们的博客:引入Shopify订阅api:构建与Shopify Checkout集成的应用程序以了解有关我们新的订阅api的更多信息。

2.产品订阅应用程序扩展

为了使本地工具成为新订阅体验的核心，我们发布了一种新的应用程序扩展，允许应用程序开发人员直接在Shopify Admin中方便订阅管理。控件中的单个命令就可以创建这种新的应用程序扩展Shopify App命令行，它包括脚手架的一切，你需要开始建立一个优秀的商户体验。OB欧宝娱乐APP

Shopify App CLI还为您的产品订阅应用扩展配备了模拟器，允许您实时预览脚手架应用扩展代码的更改。

当你准备好部署你的应用扩展时，你可以把它推到你的合作伙伴仪表板上，在那里你可以完全控制版本历史，并通过点击一个按钮将你的应用扩展发布到每一个安装了你的应用的商店。

安装了订阅应用程序的商店在Shopify管理的产品页面上呈现订阅卡，该页面将数据传递给由您发布的应用程序扩展代码提供支持的模式。整个交换发生在Shopify托管的代码之间，因此产品订阅应用程序扩展非常快。

有关构建产品订阅应用程序扩展的更多信息，请访问我们的教程．

3.计划完成目标

对该版本的最后一个基于订阅的更改是计划的实现。履行订单现在支持计划状态，它将显示任何包含预付订阅的订单。这些履行订单包括fulfillAt日期，它将过渡到计划履行订单开放说明何时过期。

从2021-01年起，API客户端还可以通过使用new将履行订单重新安排到以后的日期fulfillmentOrderReschedule突变，并指定afulfillAt在未来约会。重新安排履行订单对预付费订阅尤其有帮助，因为如果咖啡或格兰诺拉麦片等消耗品还没有用完，客户可能希望跳过它们的发货。此功能尚未通过Shopify管理UI提供，并且仅通过GraphQL API提供支持。

下面是重新安排履行订单的请求示例:

有关订阅和履行如何协同工作的详细信息，请访问我们的教程创建和管理预付订阅的实现。

4.自动激活应用程序收费

在之前的版本中，使用REST API的应用程序的计费是一个三步的过程:

• 第一步:创建应用程序收费
• 第二步商人接受或拒绝付款
• 第三步:如果收费被接受，则调用API来激活挂起接受负责

从2021-01年起，应用程序不再需要执行第三步。已接受的应用程序费用将自动转换为“激活”状态，从而消除了由应用程序创建、商家接受、但从未激活并支付给合作伙伴的费用的可能性。

5.财务报告改进

2021-01版本包括两项变化，以提高会计应用程序的准确性。

首先,TransactionFee是作为Admin GraphQL API的一部分可用的新对象。这个新对象包含了更多关于Shopify Payments支付中收取的费用的详细信息，包括统一费率收费、百分比收费以及对这些费用收取的税费明细。

其次，GraphQL管理API现在包括作为订单的一部分接收的提示，使用totalTipReceivedSet字段上的订单对象。这种增加的粒度将有助于会计应用程序更准确地报告任何给定订单交易的费用和小费。

紧跟变化

对于Shopify平台的所有更改，请务必订阅开发人员的变更，是所有新产品发布的主要信息来源。使用更新日志保持最新状态，并在即将发布的2021-01候选版本中尽快采用新功能，从而保持领先地位。

您还可以订阅我们的合作伙伴和开发者在Shopify的月度通讯，这将帮助您了解所有平台更新: