进阶 v0.dev 2026-11-12 04:30:30 · 17 阅读

第21章 v0 与 Shopify 集成

Shopify

Shopify 集成让你在 v0 中搭建的在线商店能够接入真实的 Shopify 商店。当你描述一个电商应用时,v0 会连接 Shopify 商店,在 Shopify 中创建产品及其图片,并生成一个通过 Shopify Storefront API 实时读取数据的前端界面。

由于前端是一个完整生成的应用,它不受限于标准的产品网格布局。你可以在真实商品目录的基础上构建任意购物体验。已有用户构建了从生产级运动鞋商店到类似游戏的商店,你可以四处走动、进店购物并购买真实产品。

v0 与 Shopify 协同构建的内容

连接 Shopify 后,v0 始终会生成一个由你的 Shopify 目录支持的前端应用。前端是主要交付物,v0 会将其与你的商店端到端对接:

  • 产品存储在 Shopify 中,而非你的代码里。v0 通过 Shopify Admin API 创建产品,并将其添加到 Vercel Storefront 销售渠道。它绝不在应用中硬编码产品名称、价格或描述。
  • 产品图片由系统生成并上传至 Shopify。v0 为每个产品生成图片并存储在 Shopify 的产品记录中,确保你的商品目录始终是唯一的数据源。
  • 前端在运行时读取产品。生成的应用在渲染时从 Shopify Storefront API 获取产品数据,因此随着商品变更,它能与你的 Shopify 目录保持同步。

开始构建商店

当你的提示词描述在线商店时,v0 会自动安装 Shopify 集成。诸如“构建前端”、“搭建在线商店”或“在线销售产品”等短语均可触发此功能。

示例:构建一个销售手工陶瓷杯的在线商店。创建几个带有价格和图片的产品。

v0 会创建一个 Shopify 开发商店,在其中生成你的产品,并将其连接到你的项目,以便前端能读取目录。你无需先在 Shopify 中配置任何内容即可开始构建。

Shopify AI 工具包

v0 通过 Shopify AI 工具包与你的商店交互,该工具包使用两个 Shopify API:

  • Admin API:用于管理商店,包括创建产品、上传产品图片和管理产品集合。
  • Storefront API:用于在生成的应用中读取商品目录并处理购物车和结账功能。

你通过提示词与工具包交互。让 v0 添加或修改产品,它会在 Shopify 中执行更改,并更新前端以保持一致。

上线付费商店

默认情况下,你的应用使用的是 Shopify 开发商店。开发商店用于构建和测试,在认领并选择 Shopify 套餐之前,无法接收真实订单。

当你发布连接了未认领开发商店的应用时,v0 会在发布流程中添加一个商务模式步骤。若要上线以处理真实订单和支付:

  1. 发布你的应用。当应用使用开发商店时,发布流程会显示商务模式步骤。
  2. 在 Shopify 开发模式下,选择“认领商店”。这会在新的标签页中打开 Shopify。
  3. 在 Shopify 中完成认领并选择套餐。

你也可以选择“继续”,在保留开发商店的情况下发布。在认领之前,已发布的应用将继续使用开发商店,且无法接收真实订单。

连接你的 Shopify 账户

认领商店后,v0 代表你通过 Admin API 执行的操作(如管理产品和订单)需要你授权自己的 Shopify 账户。当需要此授权时,v0 会在聊天界面中内联显示“连接 Shopify”卡片。

选择“连接 Shopify 账户”并完成 Shopify 授权。连接完成后,v0 将自动继续该步骤。

如果 v0 要求你连接 Shopify 账户,请使用内联的“连接 Shopify 账户”按钮。你无需进入设置、断开并重新连接、开启新聊天或联系客服。

最佳实践

  • 描述商店及其产品。v0 会在 Shopify 中为你创建产品,因此请告诉它你要卖什么,而不是粘贴占位数据。
  • 让 v0 管理商品目录。要求 v0 添加或编辑产品,而不是在应用中硬编码,以确保前端和 Shopify 商店保持同步。
  • 同时迭代前端和商品目录。你可以在同一聊天中更改产品详情、添加集合以及调整前端布局。

示例提示词:

  • 给商店添加三个产品,每个产品带有图片和简短描述。
  • 重新生成陶瓷杯的图片,使其看起来更极简、更具影棚灯光感。
  • 创建一个“精选”集合,并将其显示在主页上。

故障排除

v0 提示我连接 Shopify 账户

对于已认领的商店,这是正常现象。某些 Admin API 操作需要用户级别的授权。在内联卡片上选择“连接 Shopify 账户”并完成 Shopify 授权,然后让 v0 重试该步骤。

我的前端没有显示产品

前端在运行时从 Shopify 读取产品,因此只显示商店中存在且已添加到 Vercel Storefront 销售渠道的产品。让 v0 创建产品,或在你的 Shopify 管理后台确认产品已发布到该销售渠道。

结账页面显示“需要密码”

Shopify 开发商店受密码保护。v0 构建的结账链接会打开在线商店结账页面,因此在商店仍受保护时,结账功能依然可用。如果在结账时看到“需要密码”页面,请让 v0 重新构建结账链接,使其打开在线商店结账页面。

环境变量

v0 连接商店时,会在你的项目中设置以下环境变量。你无需配置它们,v0 会为你管理。

变量描述
SHOPIFY_STORE_DOMAIN已连接的 Shopify 商店的主机名。
SHOPIFY_STOREFRONT_ACCESS_TOKEN应用运行时用于读取产品的 Storefront API 访问令牌。

Storefront 访问令牌的权限范围仅限于公开的前端读取。v0 在生成过程中处理 Admin API 操作(创建产品、上传图片、管理集合),因此请勿将管理凭据放在客户端代码中。

上一篇:Snowflake
下一篇:外部 API

评论 (0)