Shopify 私有 App 与自定义 App 的区别

简单回答：Shopify 的「私有 App（Private app）」是旧概念，已经停止新建，由「自定义 App（Custom app）」取代；两者的用途相同，都是为单一店铺提供 API 访问、不经过 App Store 分发，但自定义 App 采用更现代的权限模型和令牌机制。与它们相对的是「公开 App（Public app）」，即 App Store 中面向所有商家分发、需要通过 Shopify 审核的 App。如果今天有人要为你的店铺对接 ERP 或开发专属功能，正确的选择就是自定义 App。

三种 App 的定位

• 公开 App：由第三方开发者开发，上架 Shopify App Store（也可以不上架公开列表，以链接方式分发），可被任何店铺安装，必须通过 Shopify 的审核，使用 OAuth 授权流程。
• 自定义 App：为某一个店铺专门创建，仅该店铺可以安装，不需要 Shopify 审核。常用于店铺与内部系统的数据对接、定制化后台工具、专属前台功能。
• 私有 App（已停用）：自定义 App 出现之前的旧方案，使用固定的 API 密钥和密码。Shopify 已不再允许创建新的私有 App，仍在运行的旧私有 App 建议迁移到自定义 App，具体时间线以 Shopify 官方公告为准。

自定义 App 能做什么

自定义 App 通过 Admin API 读写店铺数据，能力取决于你授予的访问范围（Scopes），例如：

• 读取和修改商品、库存、价格，实现 ERP 到 Shopify 的商品同步。
• 读取订单并回写物流单号与履行状态，实现订单到仓储 / 物流系统的同步。
• 读取客户信息，用于 CRM 或会员系统对接。
• 管理元字段、元对象，扩展商品和店铺的数据结构。
• 通过 Storefront API 为自建的前端或小程序提供商品与结账数据。
• 配合 Theme App Extension 在主题中嵌入专属功能，参考 Shopify App Embed 应用嵌入启用方法。

如何创建自定义 App

Shopify 目前把自定义 App 的创建与管理放在 Dev Dashboard（开发者控制台）中；在此之前通过后台「设置 > 应用和销售渠道 > 开发应用」创建的旧版自定义 App 仍可在后台管理。大致流程如下，界面细节以 Shopify 官方帮助中心为准：

1. 店主或拥有「应用开发」权限的员工登录 Dev Dashboard，创建一个新 App。
2. 为 App 配置 Admin API 的访问范围，按最小权限原则只勾选需要的范围。
3. 把 App 安装到目标店铺，安装后获得 Admin API 访问令牌（Access token）。该令牌只显示一次，需要妥善保存。
4. 开发者在服务端使用该令牌调用 Admin API（推荐 GraphQL），并按需订阅 Webhook 接收订单、商品等事件通知。
5. 如需前台数据访问，另行配置 Storefront API 访问范围并获取对应令牌。

注意，协作者账号（Collaborator）无法访问 Dev Dashboard，所以服务商通常需要店主创建 App 后分享令牌，或者由店主为服务商的员工账号开通相应权限。

安全与运维要点

• 令牌就是密码：不要把 Access token 写进前端代码、聊天记录或共享文档，服务端通过环境变量管理。
• 最小权限：只授予必要的范围，权限变更后需要重新安装 App 使其生效。
• API 版本：Shopify 的 Admin API 按季度发布版本，旧版本会在一段时间后停用，自定义 App 需要定期升级 API 版本。
• 调用限制：Admin API 有速率限制，批量同步要做好节流与重试。
• 人员变动：开发者离职或更换服务商时，应撤销旧令牌并重新生成。

什么时候用自定义 App，什么时候用公开 App

• 需求是通用的（评论、邮件营销、追加销售），App Store 里有成熟产品，直接用公开 App。
• 需求涉及你自己的 ERP、WMS、财务系统或者独有的业务流程，用自定义 App。
• 你是开发者，想把功能卖给其它商家，那就要走公开 App 的开发与审核路线。

系统集成的整体思路可以参考 Shopify ERP、物流与仓储系统集成怎么做。

什么时候需要找服务商

自定义 App 的创建本身几分钟就能完成，但真正的工作在于 App 背后的服务端开发、数据映射、异常处理和长期维护。如果你没有自己的开发团队，或者希望把 ERP、物流、仓储与 Shopify 可靠地连起来，建议交给有 Shopify API 开发经验的服务商。创意时空从 2017 年起从事 Shopify App 与系统集成开发，是 Shopify Plus Partner，欢迎 联系我们。