shopify-developer

Shopify 開発者リファレンス

プロフェッショナルな Shopify 開発の包括的なリファレンス — API バージョン 2026-01。

クイックリファレンス

項目	値
API バージョン	2026-01（安定版）
GraphQL Admin	POST https://{store}.myshopify.com/admin/api/2026-01/graphql.json
Storefront API	POST https://{store}.myshopify.com/api/2026-01/graphql.json
Ajax API（テーマ）	/cart.js、/cart/add.js、/cart/change.js
CLI インストール	npm install -g @shopify/cli
テーマ開発	shopify theme dev --store {store}.myshopify.com
アプリ開発	shopify app dev
デプロイ	shopify app deploy
ドキュメント	shopify.dev

作業内容に応じて選ぶ

タスクに合ったリファレンスファイルをお読みください。

Liquid テンプレート — .liquid ファイルの作成やデバッグ：

• references/liquid-syntax.md - タグ、制御フロー、反復処理、空白、LiquidDoc
• references/liquid-filters.md - すべてのフィルターカテゴリと例
• references/liquid-objects.md - 商品、コレクション、カート、顧客、グローバルオブジェクト

テーマ開発 — テーマの構築やカスタマイズ：

• references/theme-development.md - OS 2.0 アーキテクチャ、セクション、ブロック、JSON テンプレート、設定スキーマ

API 統合 — プログラムによるデータの取得や変更：

• references/api-admin.md - GraphQL Admin API（主要）、REST（レガシー）、OAuth、ウェブフック、レート制限
• references/api-storefront.md - Storefront API、Ajax API、カート操作

アプリ開発 — Shopify アプリの構築：

• references/app-development.md - Shopify CLI、拡張機能、Polaris Web Components、App Bridge

サーバーレスロジック — カスタムビジネスルール：

• references/functions.md - Shopify Functions（Scripts に代わるもの）、Rust/JS ターゲット、デプロイ

ヘッドレスコマース — カスタムストアフロント：

• references/hydrogen.md - Hydrogen フレームワーク、React Router 7、Storefront API 統合

最適化とトラブルシューティング：

• references/performance.md - 画像、JS、CSS、フォント、Liquid、Core Web Vitals
• references/debugging.md - Liquid エラー、API エラー、カートの問題、ウェブフックの失敗

非推奨に関する通知

非推奨の項目	置き換え先	期限
Shopify Scripts	Shopify Functions	2025年8月（移行）、終了時期は未定
checkout.liquid	Checkout Extensibility	2024年8月（Plus）、完了
REST Admin API	GraphQL Admin API	非推奨化中（削除日は未定）
レガシーカスタムアプリ	新しい認証モデル	2025年1月（完了）
Polaris React	Polaris Web Components	移行中
Remix（アプリフレームワーク）	React Router 7	Hydrogen 2025.5.0+

Liquid の基本

3 種類の構文：

{{ product.title | upcase }}                    {# Output with filter #}
{% if product.available %}In stock{% endif %}   {# Logic tag #}
{% assign sale = product.price | times: 0.8 %}  {# Assignment #}
{%- if condition -%}Stripped whitespace{%- endif -%}

主なパターン：

{% for product in collection.products limit: 5 %}
  {% render 'product-card', product: product %}
{% endfor %}

{% paginate collection.products by 12 %}
  {% for product in paginate.collection.products %}...{% endfor %}
  {{ paginate | default_pagination }}
{% endpaginate %}

API の基本

// GraphQL Admin - always use GraphQL over REST
const response = await fetch(`https://${store}.myshopify.com/admin/api/2026-01/graphql.json`, {
  method: 'POST',
  headers: {
    'X-Shopify-Access-Token': accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query, variables }),
})
const { data, errors } = await response.json()
if (errors) throw new Error(errors[0].message)

// Ajax API (theme-only cart operations)
fetch('/cart/add.js', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ id: variantId, quantity: 1 }),
})

参照ファイル

ファイル	行数	対象範囲
liquid-syntax.md	~600	タグ、制御フロー、反復処理、変数、空白、LiquidDoc
liquid-filters.md	~870	文字列、数値、配列、Shopify 固有、日付、URL、色のフィルター
liquid-objects.md	~695	すべての Shopify オブジェクト：商品、バリエーション、コレクション、カート、顧客、注文など
theme-development.md	~1200	ファイル構造、JSON テンプレート、セクション、ブロック、設定スキーマ、レイアウト
api-admin.md	~595	GraphQL クエリ／ミューテーション、REST（レガシー）、OAuth、ウェブフック、レート制限
api-storefront.md	~235	Storefront API、Ajax API、カート操作、Customer Account API
app-development.md	~760	CLI、アプリのアーキテクチャ、拡張機能、Polaris Web Components、デプロイ
functions.md	~300	Function の種類、Rust／JS ターゲット、CLI ワークフロー、Scripts の移行
hydrogen.md	~375	セットアップ、ルーティング、データ読み込み、Storefront API、デプロイ
performance.md	~605	画像、JS、CSS、フォント、Liquid、サードパーティ製スクリプト、Core Web Vitals
debugging.md	~650	Liquid、JavaScript、API、カート、ウェブフック、テーマエディターのトラブルシューティング