工具与应用 · Shopify API:四月版本发布信息
本文总结了2020年4月发布的API功能。请充分利用这些最新的API功能来提升您的应用程序质量。
本文总结了2020年4月发布的API功能。请充分利用这些最新的API功能来提升您的应用程序质量。
2020年1月版本的主要更新集中在产品、订单和发货处理流程上。本季度版本则解决了结账时关税和税费计算处理以及店铺API更新等问题。
现在,让我们仔细看看 2020 年 4 月发布的新功能,包括结账期间的验证和店铺 API 对象的附加字段。
- 关税和税款的计算
- 添加了使用 `compare at` 进行价格比较的验证。
- 与产品和订单相关的店铺 API 的其他字段
- 显示富媒体文件的文件名
1. 关税和税款的计算
对于进行国际销售的商家来说,让买家在结账时支付关税可以降低风险,因为存在海关延误、额外运费以及买家拒收货物等风险。
2020年4月版本新增了关税和税费的开发者预览版。这使您可以提前了解客户如何在结账时估算关税和税费,从而为买家提供清晰的总价。这不仅有助于买家支付关税,还有助于您了解税费在您应用程序工作流程中的位置。
注意:在开发者预览期间,关税和税款将为占位符值。
此版本允许应用程序通过 REST 和 GraphQL 管理 API 读取订单下单时支付的关税,并通过 GraphQL API 处理退款。对于产生退款和关税的订单,商品详情中新增了 `duties` 字段。订单信息现在可以同时引用退款后的 `current_total_duties_set` 和原始的 `original_total_duties_set`。
最重要的是,所有 API 版本中,订单的总价 (total_price_set) 现在都将包含结账时支付的关税。此功能正式上线后,所有提供关税和税费计算服务的商店都将默认显示包含关税在内的订单总金额,并且在退款时也需要处理适用订单的关税。
有关通过 API 获取海关和税务信息退款的详细信息,以及包含关税信息的应用程序更新,请查看教程。
2. 使用 `compare at` 添加价格比较验证。
为了确保应用能够信任 `compare_at_price` 与 `price` 字段值之间的关系,我们添加了验证机制,以确保比较价格始终高于实际价格。此项更改使得应用可以在收据等新位置显示 `compare_at_price`,而无需担心出现异常值。
只有当字段被修改时才会应用验证,因此在使用传递整个对象的库的应用程序中,如果修改的是无关字段(例如变体权重),则不会涉及验证。
有关此新验证功能的更多信息,请参阅版本控制指南。
3. 与产品和订单相关的其他 Storefront API 字段
2020年1月版本引入了订单编辑功能,从而可以更全面地管理店铺订单,包括编辑产品详情和现有订单。店铺 API 的订单对象已更新以反映这些新功能,并添加了新字段,以确保即使在编辑后也能准确显示自定义店铺订单。
新的店面订单对象不仅包含 LineItem 对象,还包含订单编辑信息、发货状态和价格详情。
作为 2020-04 版本的一部分,我们还在 Storefront API 中发布了新的字段,以支持翻译、国际化以及库存状态和数量。
有关新 Storefront API 字段的完整概述,请参阅发行说明。
4. 披露富媒体文件名
最新 API 版本为 GraphQL 中的产品引入了媒体集成。为了简化媒体文件的处理,我们现在使用两个新字段公开媒体文件名:`expose_video_filename` 和 `expose_model3d_filename`。
有关如何使用此连接以及如何将富媒体体验融入产品页面的信息,请参阅我们的产品媒体使用指南。
推迟 2019-04 版本的停用
正如我们在之前的帖子中宣布的那样,为了让我们能够在当前情况下集中精力支持其他合作伙伴和商家,我们决定将 2019-04 版本的弃用日期推迟到 2020 年 7 月 1 日。取而代之的是,API 的 2019-04 和 2019-07 版本都预计将于 7 月 1 日弃用。
此次延迟意味着,从7月1日起,所有接口的分页方式将从基于页面的分页更改为基于游标的分页,从而简化应用迁移流程。您可以在我们关于如何使用相对分页的文章中找到更多关于应用迁移的详细信息。
感谢所有为此次更新付出辛勤努力的同事,也感谢你们的理解与合作。你们已经领先一步,现在我们希望你们能将精力集中在自身业务、客户和应用用户最迫切需要解决的问题上。
请查阅有关变更的最新信息。
阅读更多
- Shopify合作伙伴对COVID-19的应对措施
- 在网上商店中明确标明送货时间的重要性
常问问题
2020年4月发布了哪些API功能?
我如何才能查看最新的变更信息?
关于推迟停止使用 2019-04 版本的相关事宜
加入 Shopify 合作伙伴计划,拓展您的业务。无论您提供营销、定制、网页设计还是开发服务,Shopify 合作伙伴计划都能助您走向成功。加入该计划完全免费,您将获得收益分成机会,并可使用丰富的工具来发展您的业务。立即加入我们充满活力的电商社区!
分享这篇文章
- 在 Facebook 上分享
- 分享至 X
- 在领英上分享






