BREAKING CHANGE

marketCurrencySettingsUpdate 廃止と移行手順

2027-01で完全削除――marketCreate / marketUpdate への移行が必須

marketCurrencySettingsUpdate2027-01 で削除現在は毎回エラーを返す→marketCreate新規マーケット+通貨設定marketUpdate既存マーケットの通貨変更2026-10 以前サポート期間中はそのまま利用可

GraphQL Admin API 2027-01 から marketCurrencySettingsUpdate ミューテーションおよび関連型が完全削除されます。2025-04 以降すでにすべてのリクエストがエラーを返している状態のため、実質的な機能喪失はありませんが、2027-01 ではフィールド自体が消えることでリクエスト全体がバリデーション段階で弾かれるようになります。

1何が変わるのか:Before / After 図解

Before (〜2026-10)mutation {marketCurrencySettingsUpdate( input: { ... }) { MarketCurrencySettingsUpdatePayload userErrors { ... }}}※ 2025-04〜: 常に UNIFIED_MARKETS_ENABLED エラーAfter (2027-01〜)mutation {marketCreate(input: { currencySettings: { ... }}) { ... }# またはmarketUpdate(input: { currencySettings: { ... }}) { ... }※ 通貨設定を直接 input に含める

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 バージョンはサポート期間中は影響なし。ただし現時点でも当ミューテーションは常にエラーを返しており、通貨設定は更新されていない点に注意。

移行先 API

marketCreate と marketUpdate はどちらも通貨設定を input に直接受け取る。別途ミューテーションを追加呼び出しする必要はなく、むしろ呼び出し回数が削減される。

非影響範囲

すでに marketCreate / marketUpdate で通貨設定を管理しているアプリは対応不要。ストアの Markets Home 設定自体には影響しない。

廃止経緯

2025-04 での Markets Home ローンチ時に deprecated 指定。同バージョン以降はすべてのリクエストが UNIFIED_MARKETS_ENABLED ユーザーエラーを返す状態が続いていた。

5移行チェックリスト

STEP 1ログ・コードで呼び出し箇所を洗い出す→STEP 2marketCreate /marketUpdate に書き換える→STEP 32026-10 以前のバージョンで動作確認→STEP 42027-01 で最終検証・リリース

marketCurrencySettingsUpdate は2027-01で完全削除されるため、今すぐ marketCreate / marketUpdate への移行を進めることで、将来の突然のリクエスト全体失敗リスクをゼロにできます。

Source: https://shopify.dev/changelog/removing-marketcurrencysettingsupdate-mutation | 公開日: 2026年9月22日