2月 21, 2026

Metafieldと連携した商品オプション

2月 21, 2026

Metafieldを連携した商品オプションの実装

ShopifyのAdmin GraphQL APIの2024年4月版において、Metafieldを連携した商品オプションを作成するための新規機能が追加されました。この機能は、productOptionsCreate、productCreate、productOptionUpdateといったmutationを利用してMetafieldを連携した商品オプションを作成することが可能となります。今回は、この新機能を活用した商品オプションの実装方法について詳しく解説します。

技術的課題の定義と現状分析

これまでのShopifyでは、商品オプションをMetafieldと連携させることができませんでした。これにより、商品オプションに対して独自のデータフィールドを追加するといった、より柔軟なカスタマイズが求められていました。

具体的な技術的ソリューションの提案

この問題を解決するために、Admin GraphQL APIの新規mutationを使ってMetafieldを連携した商品オプションを作成します。具体的には、productOptionsCreateで商品オプションを作成し、productCreateで商品を作成、productOptionUpdateで商品オプションを更新します。

実装手順とコード例

以下に、Metafieldを連携した商品オプションを作成するGraphQLのコード例を示します。

mutation {
  productCreate(input: {
    title: "Sample Product",
    productType: "Custom",
    options: [
      {
        title: "Size",
        metafields: [
          {
            namespace: "custom",
            key: "extra_info",
            value: "This option has extra info.",
            valueType: "STRING"
          }
        ]
      }
    ]
  }) {
    product {
      id
    }
    userErrors {
      field
      message
    }
  }
}

このコードは、"Size"という商品オプションを持つ"Sample Product"という商品を作成し、その商品オプションに対してMetafieldを追加しています。Metafieldの値は"STRING"タイプで、"This option has extra info."としています。