浏览文档

维护方

创建 Shopify 应用并连接 OOMOL

连接之前,准备一个可以创建应用的 Shopify 账号,并确认你有目标店铺的应用安装权限。

1. 创建应用

  1. 登录 Shopify Dev Dashboard。
  2. 打开 Apps,点击 Create app。
  3. 选择 Start from Dev Dashboard。
  4. 填写应用名称,例如 OOMOL Shopify,然后点击 Create。

2. 配置应用版本

进入应用的版本配置页面,填写 App URL。如果没有单独的应用首页,可以使用 Shopify 提供的 https://shopify.dev/apps/default-app-home,并关闭嵌入 Shopify 后台的选项。

在 Scopes 中选择权限:

你想做什么勾选的权限
查看和管理订单read_orders, write_orders
查看和管理商品read_products, write_products
查看和管理客户、地址read_customers, write_customers
查看和调整库存read_inventory, write_inventory

管理商品和订单时,勾选前两组;还要同步客户或调整库存,再加上对应的一组。如果只打算查询,不修改店铺数据,可以只选对应的 read_* 权限。

客户姓名、邮箱、电话和地址可能还需要 Shopify 审批。遇到访问限制时,按受保护客户数据申请说明补充申请。

3. 填写回调地址并发布

  1. 打开 OOMOL 的 Shopify 连接入口,选择 OAuth2,找到提供的回调地址。
  2. 复制完整地址,粘贴到 Shopify 应用的 Redirect URLs 中。
  3. 保存配置,点击 Release 发布版本。

回调地址直接复制即可,不要修改路径或自行添加结尾斜杠。

4. 复制应用凭据

回到 Shopify 应用的 App settings,找到 Client ID 和 Client secret。

在 OOMOL 的 Shopify OAuth 客户端配置中,将这两个值填入同名字段,然后保存。

5. 连接店铺

  1. 在 OOMOL 中继续连接 Shopify。
  2. 在店铺域名一栏填写你的 myshopify.com 域名,例如 acme.myshopify.com。
  3. 检查申请权限列表。默认已填订单和商品的读写权限;如果在 Shopify 中增加或删减了权限,这里也改成相同的列表。
  4. 发起连接,在打开的 Shopify 页面确认店铺,完成安装或授权。
  5. 回到 OOMOL,确认店铺显示为已连接。可以先读取店铺信息或查询几件商品,检查是否连到了正确的店铺。

遇到问题时

现象怎么处理
提示回调地址不匹配回到 OOMOL 重新复制回调地址,替换 Shopify 中的 Redirect URLs。
找不到店铺,或店铺不能安装确认登录的是有安装权限的账号,并检查应用的分发设置是否允许该店铺安装。
连接成功,但某项操作提示权限不足在 Shopify 中补上该操作所需权限,发布新版本;更新 OOMOL 的申请权限列表,再连接一次。
更换了 Client secret 后连接失败把新值保存到 OOMOL,然后重新连接店铺。

Shopify 页面入口变化时,可对照官方的创建应用教程。

开始使用

开始使用