MENU
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
  1. ホーム
  2. Shopifyニュース
  3. 【Shopify最新ニュース2026・開発者向け】Market.metafields、2027-01 からキーの大小文字を区別せず

【Shopify最新ニュース2026・開発者向け】Market.metafields、2027-01 からキーの大小文字を区別せず

2026 11/17
2026年11月17日
Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだマグカップを両手で持つ写真に「Market.metafields 2027-01で大小不問」の見出し

開発者向けの変更です。

対象は、Storefront API でマーケットのメタフィールドを読むアプリとカスタムストアフロント。

2027-01 から、Market.metafields はキーの大文字と小文字を区別しません

Storefront API の 2027-01 からの変更です。

2027-01 の Market.metafields は、大文字と小文字の違いを問わずにキーを照合します。

発表は2026年11月13日の developer changelog です。

出典: Shopify developer changelog「Market.metafields matches keys in any case as of Storefront API version 2027-01」2026年11月13日
https://shopify.dev/changelog/posts/market-metafields-matches-keys-in-any-case-as-of-storefront-api-version-2027-01

フラグは次の2つです。

  • Breaking API Change
  • Action required

タグは「Storefront API」です。

As of Storefront API version 2027-01, the metafields field on the Market object matches each requested key in any case, as Market.metafield already does.
(Storefront API のバージョン 2027-01 から、Market オブジェクトの metafields フィールドは、Market.metafield がすでにそうしているように、求められた各キーを大文字と小文字を問わずに照合します)

単数形の Market.metafield は、もとから大文字と小文字を区別しない作り。

複数形の Market.metafields が、それにそろう形です。

2026-10 までの Market.metafields は、大文字と小文字がそろわないと null を返します

2026-10 以前の Market.metafields は、キーの大文字と小文字の一致を求めます。

求めたキーと保存されたキーで大文字と小文字が違うと、値が返りません。

公式の例は、名前空間 custom・キー colour のメタフィールドです。

In version 2026-10 and earlier, the entry for { namespace: “custom”, key: “Colour” } is null.
In version 2027-01, the entry returns the stored metafield.
(バージョン 2026-10 以前では、namespace が custom・key が Colour の項目は null です。バージョン 2027-01 では、保存されたメタフィールドが返ります)

例で null になるのは、頭が大文字の Colour で求めた場合。

2027-01 では、同じ求め方で保存された値が返ります。

影響するのは、2つの条件のどちらかに当たるアプリです

公式は、影響する条件を2つ挙げています。

It requests a key in a different case from the key that the market stores.
The buyer’s markets store the same key in different cases.
(マーケットが保存するキーと違う大文字と小文字でキーを求めている。購入者のマーケットが、同じキーを違う大文字と小文字で保存している)

対象のクエリは、次の2つを満たすものです。

  • Localization.market か Country.market から、Market のメタフィールドを読む
  • Storefront API のバージョンが 2027-01 以降

Market.metafield だけを使うアプリは対象外です

キーを保存されたとおりの大文字と小文字で求めるアプリも、影響を受けません。

Your app isn’t affected if it requests each key in the case that the markets store it, or if it uses only Market.metafield, which already matches keys in any case. Versions 2026-10 and earlier don’t change.
(各キーをマーケットが保存したとおりの大文字と小文字で求めるアプリや、すでに大文字と小文字を問わずに照合する Market.metafield だけを使うアプリは影響を受けません。バージョン 2026-10 以前は変わりません)

2026-10 以前のバージョンの動きは、そのまま。

2つのフィールドを比べると、影響の有無を見分けられます

公式は、今のバージョンで Market.metafield と Market.metafields を比べる方法を示しています。

So on the version that you use today, Market.metafield returns the result that Market.metafields returns in 2027-01. You can compare the two fields to find out whether the change affects your app.
(そのため、今使っているバージョンでも、Market.metafield は 2027-01 の Market.metafields と同じ結果を返します。2つのフィールドを比べれば、変更がアプリに影響するかを見分けられます)

比べ方は、アプリが読むマーケットのメタフィールドごとに、同じ名前空間とキーで2つを求める形。

結果が全て同じなら、変更は要りません。

違いがあり、アプリやストアフロントに大きく響く場合の対応も示されています。

アプリとメタフィールドを、キーの大文字と小文字に頼らない形に直すよう公式は勧めています。

For example, request each key in the case that your markets store it, and use one case for each key on every market.
(たとえば、各キーをマーケットが保存したとおりの大文字と小文字で求め、どのマーケットでも各キーの大文字と小文字を1通りにそろえます)

🔴 公式に書かれていないこと

次の点は、一次ソースにありません。

  • Storefront API 2027-01 の公開日や、2026-10 の提供が終わる日は、この一次ソースには書かれていません
  • 同じだけ具体的なマーケット同士で、大文字と小文字だけが違う同じキーを保存しているときの扱いは書かれていません。2027-01 では両フィールドが同じメタフィールドを返し、Market.metafield は購入者の最も具体的なマーケットのものを返す、とあります
  • 店の側で何か操作が要るかは書かれていません。対象として書かれているのはアプリとカスタムストアフロントです
  • Liquid や Function API に同じ変更があるかは書かれていません。タグは Storefront API だけです
  • 🔴 本記事は一次ソースの「Related docs」の文書を読んでいません。クエリも実際には送っていません。記載が無いことをもって「できる」とも「できない」とも書きません

開発者と店がやることを整理します

開発者がやることは次の3つです。

  1. Storefront API で Market.metafields を使っているクエリを洗い出す
  2. 今のバージョンで、同じ名前空間とキーに Market.metafield と Market.metafields を当て、結果を比べる
  3. 結果が違うキーは、2027-01 に移る前に、保存されたとおりの大文字と小文字で求めるように直す

店がやることは次の1つです。

  1. カスタムストアフロントやアプリを作ってもらっている店は、マーケットのメタフィールドの大文字と小文字をそろえる予定を作り手に聞く

🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。

出典

  • Shopify developer changelog「Market.metafields matches keys in any case as of Storefront API version 2027-01」2026年11月13日
    https://shopify.dev/changelog/posts/market-metafields-matches-keys-in-any-case-as-of-storefront-api-version-2027-01

上記の Shopify 公式の情報だけを一次情報として使っています。

Shopifyニュース
API変更 shopify Shopifyアプリ 越境EC
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • 【Shopify最新ニュース2026・開発者向け】マーケットのメタフィールド、並んだら handle の順で値を決定
  • 【EC最新ニュース2026】日本郵便の委託先CBcloudの「ピックゴー」に不正アクセス、一部の荷物のお客さまのお名前の漏えいが確認されました

この記事を書いた人

テスタのアバター テスタ

さっぱりした性格で、率直。テンションは一定で、感情に流されない。褒めるときは短く的確、厳しいこともちゃんと言うが、人格否定はしないフェアさがある。遠回りが嫌いで、結論までの道筋をシンプルにしたがる。

関連記事

  • Shopifyニュースのアイキャッチ:ノートとクリップの皿が置かれた机で、布のトートバッグに封筒を入れる両手の写真に「IPとASNを併用 IPは250個まで」の見出し
    【Shopify最新ニュース2026・開発者向け】アプリの IP allowlist が IP アドレスと ASN の併用に対応、IP アドレスは250個まで
    2026年11月17日
  • Shopifyニュースのアイキャッチ:灰色のフェルトの上の段ボール箱にテープを押さえる両手の写真に「allowlist無しは bulk制限が開始 パートナーはMFA必須へ」の見出し
    【Shopify最新ニュース2026・開発者向け】IP allowlist の無い公開アプリで bulk operations の制限が始まり、パートナーは MFA 必須へ
    2026年11月17日
  • Shopifyニュースのアイキャッチ:木の机の上で、紙の緩衝材を敷いた白い箱に瓶詰め2つを収める両手の写真に「並んだマーケットの値は handle 順で決定」の見出し
    【Shopify最新ニュース2026・開発者向け】マーケットのメタフィールド、並んだら handle の順で値を決定
    2026年11月17日
  • Shopifyニュースのアイキャッチ:段ボール箱に入ったニットを薄紙で包む両手の写真に「下書きのカスタム割引 表示通貨で扱う」の見出し
    【Shopify最新ニュース2026】下書き注文のカスタム割引が、ストアの通貨から表示通貨に
    2026年11月16日
  • Shopifyニュースのアイキャッチ:古い木の机で段ボールの小箱を開ける両手とスマートフォンの写真に「Store activity log 履歴が最大18か月分に」の見出し
    【Shopify最新ニュース2026】Store activity log を刷新、誰が何を変えたかを最大18か月分
    2026年11月16日
  • Shopifyニュースのアイキャッチ:緩衝材の入った段ボール箱の上で白いカードにペンで書こうとする両手の写真に「カスタムアプリもIP allowlist必須に」の見出し
    【Shopify最新ニュース2026・開発者向け】組織の外の店に入れたカスタムアプリも IP allowlist が必須に
    2026年11月15日
  • Shopifyニュースのアイキャッチ:段ボール箱の中のスニーカーの靴ひもを整える両手の写真に「App Store掲載を自分で取り下げ」の見出し
    【Shopify最新ニュース2026・開発者向け】Shopify App Store の掲載取り下げ、Partner Dashboard で自分で可能に
    2026年11月15日
  • Shopifyニュースのアイキャッチ:紺の机で白い薄紙にグレーのニットを包む両手の写真に「申請の日時を通知メールに表示」の見出し
    【Shopify最新ニュース2026】返品とキャンセルの申請日時、Liquid 変数で通知メールに表示可能に
    2026年11月15日

最近の投稿

  • 【Shopify最新ニュース2026・開発者向け】アプリの IP allowlist が IP アドレスと ASN の併用に対応、IP アドレスは250個まで
  • 【Shopify最新ニュース2026・開発者向け】IP allowlist の無い公開アプリで bulk operations の制限が始まり、パートナーは MFA 必須へ
  • 【EC最新ニュース2026】日本郵便のUGX送り状作成システム「Hubez」が11月12日に再開 初回ログイン時はメール認証が必要
  • 【EC最新ニュース2026】日本郵便の委託先CBcloudの「ピックゴー」に不正アクセス、一部の荷物のお客さまのお名前の漏えいが確認されました
  • 【Shopify最新ニュース2026・開発者向け】Market.metafields、2027-01 からキーの大小文字を区別せず

運営: 株式会社ギャザリング

  • プライバシーポリシー
  • 運営者情報
  • お問い合わせ

© ECサイトshopifyならキクシル.

目次