使用 Shopify Functions 创建新折扣类型的应用现在可以注册shopify/Discount应用意图,这使得 Sidekick 能够启动应用的create和edit流程,并在消歧选择器中推广它们。
应用可以使用以下任一目标注册意图:
- admin.app.intent.link 在 React Router 应用中导航至现有页面。
- admin.app.intent.render以内联方式呈现聚焦的管理员界面扩展,此目标需要 API 版本为2026-04或更高版本。
使用admin.discount-details.function-settings.render的折扣 UI 扩展会自动获得推广。
移动支持:admin.app.intent.link折扣流程目前仅在 Web 版 Shopify 管理员中受支持,应用链接折扣可能会出现在 Shopify 移动应用的折扣列表中,但点击它们不会打开应用的编辑流程;在提供移动支持之前,商家应使用 Web 版 Shopify 管理员来打开和编辑这些折扣。
变更内容
shopify/Discount意图现在支持用于应用折扣流程的create和edit操作。
注册使用shopify-intent.json元模式并引用shopify/discount.json基线模式,functionId上的matchValue将每个意图映射到特定的 Shopify Function 实现,使具有多个实现的应用能够为每个实现注册一个流程,该意图的value模式携带用于编辑流程的折扣 GID。
当请求未标识特定的折扣类型或函数实现时,商家可以在消歧选择器中选择可用的流程。
每个注册的意图都计入每应用意图限制。
extension.ui.paths属性继续有效,但我们鼓励应用声明应用意图,以便在创建和编辑流程中实现更深入的 Sidekick 集成。
受影响对象
这适用于使用 Shopify Functions 创建新折扣类型的应用。
现有应用将继续按原样运行,无需进行迁移。不创建基于 Function 的折扣类型的应用不受影响。
为何重要
商家可以一致地进入用于创建或编辑特定折扣类型的专用应用流程,而不是被路由到 Shopify 的默认折扣界面。
应用控制提供哪些 Shopify Function 实现,并可以使用现有的 React Router 页面或专注的内联 UI 扩展。
操作指南
现有应用无需采取任何操作。
要在 Sidekick 和消歧选择器中提升折扣流程的优先级:
- 构建折扣 UI 扩展,它将自动获得推广。
- 为现有的React Router 折扣 UI注册admin.app.intent.link。
- 注册admin.app.intent.render以提供聚焦的内联 UI 扩展。
有关配置示例,请参阅使用 Sidekick 构建应用操作,有关完整契约,请参阅意图 API 参考。

