---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: 创建 Shopify 应用并连接 OOMOL
description: 在 Shopify 创建应用，勾选权限并复制客户端凭据，将你的店铺连接到 OOMOL。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/shopify-oauth-app/
markdown_url: https://oomol.com/zh-cn/docs/shopify-oauth-app.md
---

# 创建 Shopify 应用并连接 OOMOL

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

## 1. 创建应用

1. 登录 [Shopify Dev Dashboard](https://dev.shopify.com/)。
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 审批。遇到访问限制时，按[受保护客户数据申请说明](https://shopify.dev/docs/apps/launch/protected-customer-data)补充申请。

## 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**。 |
| 找不到店铺，或店铺不能安装 | 确认登录的是有安装权限的账号，并检查应用的[分发设置](https://shopify.dev/docs/apps/launch/distribution/select-distribution-method)是否允许该店铺安装。 |
| 连接成功，但某项操作提示权限不足 | 在 Shopify 中补上该操作所需权限，发布新版本；更新 OOMOL 的申请权限列表，再连接一次。 |
| 更换了 Client secret 后连接失败 | 把新值保存到 OOMOL，然后重新连接店铺。 |

Shopify 页面入口变化时，可对照官方的[创建应用教程](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard)。