Shopify Flow: runtime_URL自動更新で再保存不要に
アクションURLの変更が既存ワークフローへ即時反映。マーチャントの手動再保存は不要に。
Shopify Flowのアクションに設定された runtime_url が、ワークフロー実行のたびに動的に解決されるようになりました。アプリを再デプロイしてURLを変更しても、既存ワークフローは次回実行時に自動的に新しいURLを呼び出します。マーチャントがワークフローを手動で再保存する必要はありません。2026年7月7日より適用。
01何が変わったのか：Before/After図解
USE CASES02業務に活かせる具体ユースケース3選
- 課題
- アプリのインフラを移行してAPIエンドポイントのドメインが変わったが、数百のショップが古いワークフローを使い続けている
- 打ち手
- アプリ側でruntime_urlを新ドメインに変更して再デプロイするだけでよい。各マーチャントへの連絡やワークフロー再保存依頼が不要になる
- 効果
- 移行作業の工数を大幅削減。サポートチケットの発生を抑制し、旧エンドポイントを速やかに廃止できる
- 技術メモ
- アプリの拡張機能設定でruntime_urlを更新後、shopify appをデプロイすれば次回ワークフロー実行時から新URLが使われる
- 課題
- ローカル開発中にngrokなどのトンネルURLが変わるたびに、開発ショップのワークフローを手動で更新する必要があった
- 打ち手
-
shopify app devコマンドを使えば、runtime_urlが変わっても開発ショップのワークフローに自動反映される - 効果
- 開発サイクルの無駄な手動作業が排除され、アクションのテスト・デバッグがよりスムーズになる
- 技術メモ
- 本番環境と同じ自動解決ロジックがローカル開発でも動作する。
shopify app dev実行中のみ有効
- 課題
- A/BテストやカナリアリリースのためにエンドポイントURLを段階的に切り替えたいが、ワークフローの再保存をユーザーに依頼するのは現実的でない
- 打ち手
- 新URLをruntime_urlに設定して再デプロイするだけで、次のワークフロー実行から全ショップに反映される
- 効果
- インフラ変更を計画的・段階的に実施でき、マーチャント側の操作を一切求めずにエンドポイントを切り替えられる
- 技術メモ
- URLの変更が即時に伝播するため、旧URLの廃止タイミングを過去の動作より厳密にコントロールできる
03技術者が押さえるべき5つのポイント
🔄 URLは毎回動的解決
ワークフローが実行されるたびに、Flowエンジンがアクションの最新 runtime_url を取得する。URLをワークフローにハードコードする従来の挙動は廃止された。
⚠️ 固定URLに依存していた場合は注意
「ワークフローが再アクティベートされるまでruntime_urlは変わらない」という前提でロジックを組んでいた場合は設計を見直す必要がある。URLが変わるとすぐに新エンドポイントが呼ばれる。
🛠️ ローカル開発も同挙動
shopify app dev 実行中も同じ自動解決ロジックが適用される。開発ショップで手動でワークフローを更新する手間がなくなる。
📋 必要なアクションはなし
既存のアプリ・ワークフローへの追加対応は不要。ただし上記の固定URL前提のコードがある場合は影響を確認すること。
📖 公式ドキュメントを確認
詳細は公式の「Create Flow action endpoints」を参照。APIバージョンや対象プランの明記は元記事にはないため、最新の公式ドキュメントで確認することを推奨。
「アプリのエンドポイントURLを変えてデプロイするだけで、マーチャント側の操作なしに全ワークフローへ即時反映されます」——この一文でクライアントへの提案・移行説明がシンプルに完結します。
Source: https://shopify.dev/changelog/shopify-flow-action-runtime-urls-now-update-automatically | 公開日: 2026年7月7日
Share:
Shopify Flow: Actionの破壊的変更が減少
Appストアレビュー規約1.3が強化される