Research Briefs / Shopify Apps

2026-08-13 · Platform & Apps

Shopify Apps 実務ブリーフ

プラットフォームとアプリの境界、データの置き場所、限定公開、費用感、GitHub＋CLI、ローカルテストを図中心で整理。

1. 正本は Shopify商品・顧客・注文・在庫はプラットフォーム。App はスコープ付きで接続するソフトウェア。
2. App DB は設計次第コピーしない設計も、分析・設定・同期用に自前 DB を持つ設計もある。重複＝同期と削除の設計課題。
3. デプロイは二系統shopify app deploy → 設定／extensions。Web ホスト → App Backend。費用・テストも自前DB側。

プラットフォームとアプリ

経路役割データの所在
Admin API商品・注文・顧客 CRUD正本 Shopify／コピーは任意
Storefront APIヘッドレス等Shopify 上
Webhooksイベント push受信は App。永続化は設計次第
App Home管理画面内 UIiframe＝開発者ホストが主流
ExtensionsAdmin / Checkout / Themeランタイムは Shopify
Metafields / Metaobjectsモデル延長Shopify 上

誰が何を持つか

Shopify 側（正本）

  • Products / Variants / Collections
  • Customers / Orders / Inventory
  • Files / Themes / Shop 設定
  • Metafields / Metaobjects
  • Deploy された Extension UI

App 側（開発者）

  • 設定・課金状態・同期カーソル
  • 分析コピー／集計
  • 独自エンティティ
  • Session / Offline tokens
  • App Home・API・Webhook 処理
一文: Shopify＝コマース正本。App DB＝アプリ機能の正本（＋任意の派生コピー）。コピーを持つなら同期と削除が中心課題。

データフロー

Shopify ホスト 開発者ホスト 実線＝主要 · 破線＝イベント／補助

置き場所パターン

A. API のみ

metafield 更新など。コピー最小。トークン＋一時キャッシュ程度。

B. 自前 DB

設定・同期・分析コピー・独自エンティティ。削除／暗号化責任あり。

C. Shopify 延長

App-owned / Merchant-owned / App-data metafields。秘密情報は自前 DB 推奨。

限定公開の 3 系統

Custom

特定ストア／Plus 組織。審査不要。Billing 不可。

Unlisted Public

リンク配布。レビュー・compliance webhook あり。Billing 可。

Admin custom

単一ストア。埋め込み／拡張不可。API クライアント寄り。

観点PublicCustomAdmin
範囲多数（Unlisted 可）1 or Plus 組織単一
承認あり不要不要
コマース正本ShopifyShopifyShopify
Compliance webhooks必須掲載要件外※同左※
Protected Customer Data申請ありL1/L2 常時可L2 はプラン依存
Billing API可不可不可
Extensions可可不可

※ コピーを持つなら削除設計は実務上必要。Public 必須 webhook: customers/data_request / customers/redact / shop/redact（アンインストール後 48h）。

インフラ費用感

App Backend / DB / 監視は基本自前。ストアプランとは別。会話で整理した感覚値（USD/月）。

≈ $0試作・個人検証
無料枠＋開発ストア
$5–40小さな本番
小 VPS／PaaS＋DB
$50–300+公開・分析寄り
監視・ログ・複数環境

開発・デプロイ（GitHub + CLI）

1
GitHub で管理Partner / Dev Dashboard で作成。スコープと配布を決定。
2
shopify app devトンネル付きローカル。開発ストアへ実 API 接続。
3
TOML / URL 揃えshopify.app.toml の application_url / redirect / webhook 先。
4
Web ホストへ BackendVercel / Fly / Cloud Run 等。DB・秘密情報もここ。
5
shopify app deploy設定・extensions のバージョンを Shopify へ。Web 本体は含まない。
作業デプロイ先含まないもの
shopify app deploy設定・extensions（Shopify）Web サーバ本体
ホスティング deployApp Home / API / jobsExtension バンドル
TOML / DashboardURL・スコープ・配布ランタイムデータ

ローカルテストの層

「ストアを丸ごとローカル複製」ではない。開発ストアの実 API に、ローカル／トンネルのアプリが接続する。

テスト環境メモ
純ロジック / UI 単体ローカル＋モック接続不要
API / Webhook開発ストア実スコープ・実ペイロード
App Home / Extensions開発ストア + app devAdmin 内確認
複数人並行開発ストア分割共有は衝突しやすい
運用: 単体はモック、結合は開発ストア。本番ストア実験は避ける。アンインストール後は app-owned 定義の削除方向と App DB 自前削除をセットで設計。

出典・注意