【Shopify最新ニュース2026・開発者向け】コレクション条件の metafieldInteger が API 2027-01 で廃止

2026年10月2日

開発者向けの変更です

API 2027-01 で、コレクションの条件に使う metafieldInteger が Admin GraphQL API から消えます。

掲載は2026年10月1日、開発者向けの Changelog。

出典: Shopify developer changelog「metafieldInteger collection condition removed in API version 2027-01」2026年10月1日
https://shopify.dev/changelog/metafieldinteger-collection-condition-removed-in-api-version-2027-01

Version: 2027-01
Flags: Breaking API Change / Action required
Surfaces: API
Affected APIs: Admin GraphQL API

対象は、metafieldInteger でコレクションの条件を作る・読むアプリです

移行先は metafieldInt。

As of API version 2027-01, the metafieldInteger collection source condition inputs and types is removed from GraphQL Admin API. If you use metafieldInteger to create or read collection source conditions, you need to migrate to metafieldInt before you upgrade to API version 2027-01.
（API バージョン 2027-01 で、コレクションの source condition に使う metafieldInteger の入力と型が GraphQL Admin API から削除されます。metafieldInteger でコレクションの source condition を作成・読み取りしている場合は、2027-01 に上げる前に metafieldInt へ移行する必要があります）

期限は、2027-01 に上げる前。

変わるのは、value の型です

数値で渡していた値が、文字列になります。

With metafieldInt, the value field on integer metafield conditions changes type from Int to String, to align with the metafield value field on the Storefront API.
（metafieldInt では、整数メタフィールドの条件の value フィールドの型が Int から String に変わります。Storefront API のメタフィールドの value フィールドに合わせるためです）

演算子 EQUALS・GREATER_THAN・LESS_THAN は変わらない
違いは、value が Int ではなく String になる点だけ

置き換わる型とフィールドは4つ。

CollectionSourceInclusionConditionMetafieldInteger → CollectionSourceInclusionConditionMetafieldInt
CollectionSourceInclusionConditionMetafieldIntegerRelation → CollectionSourceInclusionConditionMetafieldIntRelation
CollectionSourceInclusionConditionInput.metafieldInteger → CollectionSourceInclusionConditionInput.metafieldInt
CollectionSourceInclusionConditionUpdateInput.metafieldInteger → CollectionSourceInclusionConditionUpdateInput.metafieldInt

書き込みでは、数値を文字列で渡します

公式の例は、conditionsToCreate の1項目。

変更前: metafieldInteger: { definitionId: "gid://shopify/MetafieldDefinition/1", relation: GREATER_THAN, value: 2000 }
変更後: metafieldInt: { definitionId: "gid://shopify/MetafieldDefinition/1", relation: GREATER_THAN, value: "2000" }

フィールド名と、値の引用符。

読み取りでは、型の条件を差し替えます

差し替えるのは、フラグメントの型名です。

変更前: ... on CollectionSourceInclusionConditionMetafieldInteger { relation value }
変更後: ... on CollectionSourceInclusionConditionMetafieldInt { relation value }

2026-10 までは、旧フィールドも動きます

移行の猶予は、2026-10 まで。

metafieldInteger continues to work on API versions up to and including 2026-10. On 2026-10, integer metafield conditions resolve to CollectionSourceInclusionConditionMetafieldInt when present. In API version 2027-01, metafieldInteger is no longer available.
（metafieldInteger は 2026-10 までの API バージョンで引き続き動きます。2026-10 では、整数メタフィールドの条件があれば CollectionSourceInclusionConditionMetafieldInt として返ります。2027-01 では metafieldInteger は使えません）

2026-10 まで — metafieldInteger も動く
2026-10 — 整数メタフィールドの条件は CollectionSourceInclusionConditionMetafieldInt として返る
2027-01 — metafieldInteger は使えない
metafieldInt の動きは、2026-10 で先に試せる

対応しないまま 2027-01 に上げると、エラーになります

公式は、壊れ方まで書いています。

If you don’t update your app before you use API version 2027-01, mutations that send metafieldInteger fail validation, and queries that select CollectionSourceInclusionConditionMetafieldInteger return errors.
（2027-01 を使う前にアプリを更新しないと、metafieldInteger を送る mutation は検証で失敗し、CollectionSourceInclusionConditionMetafieldInteger を選ぶ query はエラーを返します）

送る側の mutation — 検証で失敗
読む側の query — エラー

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

店主の管理画面に変化があるかは書かれていません。対象として書かれているのは GraphQL Admin API の入力と型だけです
管理画面の自動コレクションの条件設定と同じものかは書かれていません
どのアプリが metafieldInteger を使っているかは書かれていません
2027-01 がいつ公開されるかは、この Changelog には書かれていません
既存のコレクションの条件が移行で変わるかは書かれていません。原文は、2026-10 では CollectionSourceInclusionConditionMetafieldInt として返ると書くだけです
関連ドキュメントへのリンクの先は、本記事では読んでいません
🔴 本記事は日本のストアで確認していません。上の記載が無いことをもって「影響がある」とも「影響がない」とも書きません