marketCurrencySettingsUpdate 廃止と移行手順
2027-01で完全削除――marketCreate / marketUpdate への移行が必須
GraphQL Admin API 2027-01 から marketCurrencySettingsUpdate ミューテーションおよび関連型が完全削除されます。2025-04 以降すでにすべてのリクエストがエラーを返している状態のため、実質的な機能喪失はありませんが、2027-01 ではフィールド自体が消えることでリクエスト全体がバリデーション段階で弾かれるようになります。
1何が変わるのか:Before / After 図解
2削除されるオブジェクト一覧
| 削除対象 | 種別 | 代替 |
|---|---|---|
marketCurrencySettingsUpdate |
Mutation |
marketCreate / marketUpdate
|
MarketCurrencySettingsUpdatePayload |
Type | 各ミューテーションのPayload型 |
MarketCurrencySettingsUserError |
Type | 各ミューテーションのUserError型 |
MarketCurrencySettingsUserErrorCode |
Enum | 各ミューテーションのErrorCode enum |
3業務に活かせるユースケース
- 課題
- 越境EC向けに複数マーケットを自動生成するアプリが
marketCurrencySettingsUpdateを呼んでいるが、2027-01 以降はリクエスト全体が弾かれてしまう - 打ち手
- マーケット作成フローを
marketCreate一本に統合し、currencySettingsフィールドをinputに含める形に書き換える - 効果
- API呼び出しが1回削減されてレイテンシが改善し、2027-01 以降も安定動作が保証される
- 技術メモ
- 移行後のテストは 2027-01 ベータ版 API で
marketCreateのレスポンスにmarket.currencySettingsが含まれることを確認すること
- 課題
- 既存マーケットの表示通貨を季節キャンペーン時に切り替えるバッチ処理が旧ミューテーションに依存している
- 打ち手
-
marketUpdateの input にcurrencySettingsを追加して通貨変更を一括処理するよう修正する - 効果
- バッチ処理の修正範囲が最小限で済み、移行コストを抑えながら将来の API バージョンにも追随できる
- 技術メモ
- 2026-10 以前の API バージョンでも
marketUpdateは利用可能なため、段階的なリリースが可能
- 課題
- サードパーティ連携ツールが旧ミューテーションを呼んでいるが、常に
UNIFIED_MARKETS_ENABLEDエラーが返り続けており、通貨設定が実際には更新されていないことに気づいていない - 打ち手
- ツールのAPI呼び出しログを監査し、
marketCurrencySettingsUpdateの痕跡を洗い出してmarketUpdateへの切り替えを依頼または自社実装する - 効果
- 現在すでに機能していない処理をブロック前に発見・修正でき、2027-01 移行時のインシデントをゼロに抑えられる
- 技術メモ
- Shopify Partner ダッシュボードの API 使用状況レポートで当該ミューテーションが呼ばれていないか確認すると効率的
4技術者が押さえるべき5つのポイント
2027-01 ではフィールドそのものが存在しないため、UserError ではなくスキーマバリデーションエラーとしてリクエスト全体が拒否される。部分的なエラーハンドリングでは対処不可。
2026-10 以前の API バージョンはサポート期間中は影響なし。ただし現時点でも当ミューテーションは常にエラーを返しており、通貨設定は更新されていない点に注意。
marketCreate と marketUpdate はどちらも通貨設定を input に直接受け取る。別途ミューテーションを追加呼び出しする必要はなく、むしろ呼び出し回数が削減される。
すでに marketCreate / marketUpdate で通貨設定を管理しているアプリは対応不要。ストアの Markets Home 設定自体には影響しない。
2025-04 での Markets Home ローンチ時に deprecated 指定。同バージョン以降はすべてのリクエストが UNIFIED_MARKETS_ENABLED ユーザーエラーを返す状態が続いていた。
5移行チェックリスト
marketCurrencySettingsUpdate は2027-01で完全削除されるため、今すぐ marketCreate / marketUpdate への移行を進めることで、将来の突然のリクエスト全体失敗リスクをゼロにできます。
Source: https://shopify.dev/changelog/removing-marketcurrencysettingsupdate-mutation | 公開日: 2026年9月22日






Share:
Dev DashboardでUI拡張の読み込み失敗を可視化
Shopifyアプリ価格設定:プライベートプラン上限が撤廃