2月 21, 2026

商品スコープを用いたInventoryItemの検索と更新

2月 21, 2026

「商品スコープ」を用いたInventoryItemクエリと更新の可能性

Shopify APIの新機能をご紹介します。この機能は、商品の在庫管理をより柔軟に行うことを可能にするもので、これにより開発者はInventoryItemオブジェクトのクエリと更新が可能となります。これは、write_productsとread_productsスコープを使用して行うことができます。

現状の技術スタックと問題分析

これまでのShopify APIでは、InventoryItemオブジェクトのクエリと更新は、商品スコープだけでは行えませんでした。これは、在庫管理に必要な情報を一元的に取得、更新するためには、複数のスコープを組み合わせて利用する必要がありました。これは開発の複雑さを増すだけでなく、誤ったスコープの設定により予期しないエラーが発生する可能性もありました。

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

Shopify APIが新たに提供する機能は、この問題を解消します。具体的には、以下の変更が行われています。

InventoryItemInputは、write_productsスコープだけでproduct*の変異を設定することができます。
InventoryItemは、read_productsまたはread_inventoryスコープでクエリすることができます。

実装手順とコード例

この新機能を利用するための手順は以下の通りです。

まず、アプリの設定でwrite_productsとread_productsスコープを有効にします。
次に、InventoryItemInputをproduct*の変異で設定します。
最後に、InventoryItemをread_productsスコープでクエリします。

以下に具体的なコード例を示します。


// 1. スコープを有効にする
ShopifyApp.configure do |config|
  config.scope = 'write_products, read_products'
end

// 2. InventoryItemInputを設定する
mutation {
  productUpdate(input: {
    id: "gid://shopify/Product/1234567890"
    variants: [{
      id: "gid://shopify/ProductVariant/1234567890"
      inventoryItem: {
        cost: "10.00"
      }
    }]
  }) {
    product {
      id
    }
    userErrors {
      field
      message
    }
  }
}

// 3. InventoryItemをクエリする
{
  product(id: "gid://shopify/Product/1234567890") {
    id
    variants(first: 5) {
      edges {
        node {
          inventoryItem {
            id
            cost
          }
        }
      }
    }
  }
}