创建 Shopify 应用并连接 OOMOL
连接之前,准备一个可以创建应用的 Shopify 账号,并确认你有目标店铺的应用安装权限。
1. 创建应用
- 登录 Shopify Dev Dashboard。
- 打开 Apps,点击 Create app。
- 选择 Start from Dev Dashboard。
- 填写应用名称,例如
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. 填写回调地址并发布
- 打开 OOMOL 的 Shopify 连接入口,选择 OAuth2,找到提供的回调地址。
- 复制完整地址,粘贴到 Shopify 应用的 Redirect URLs 中。
- 保存配置,点击 Release 发布版本。
回调地址直接复制即可,不要修改路径或自行添加结尾斜杠。
4. 复制应用凭据
回到 Shopify 应用的 App settings,找到 Client ID 和 Client secret。
在 OOMOL 的 Shopify OAuth 客户端配置中,将这两个值填入同名字段,然后保存。
5. 连接店铺
- 在 OOMOL 中继续连接 Shopify。
- 在店铺域名一栏填写你的
myshopify.com域名,例如acme.myshopify.com。 - 检查申请权限列表。默认已填订单和商品的读写权限;如果在 Shopify 中增加或删减了权限,这里也改成相同的列表。
- 发起连接,在打开的 Shopify 页面确认店铺,完成安装或授权。
- 回到 OOMOL,确认店铺显示为已连接。可以先读取店铺信息或查询几件商品,检查是否连到了正确的店铺。
遇到问题时
| 现象 | 怎么处理 |
|---|---|
| 提示回调地址不匹配 | 回到 OOMOL 重新复制回调地址,替换 Shopify 中的 Redirect URLs。 |
| 找不到店铺,或店铺不能安装 | 确认登录的是有安装权限的账号,并检查应用的分发设置是否允许该店铺安装。 |
| 连接成功,但某项操作提示权限不足 | 在 Shopify 中补上该操作所需权限,发布新版本;更新 OOMOL 的申请权限列表,再连接一次。 |
| 更换了 Client secret 后连接失败 | 把新值保存到 OOMOL,然后重新连接店铺。 |
Shopify 页面入口变化时,可对照官方的创建应用教程。