3月 05, 2026

新たに導入されたカタログAPIで、異なる顧客向けの価格設定と商品公開を管理しよう

3月 05, 2026

異なる顧客向けの価格設定と商品公開を管理する新たなCatalogs APIの紹介

Shopifyの最新の不安定なGraphQL APIバージョンから、Catalogs APIを用いて、異なる顧客の文脈で利用可能な商品とその価格を決定するルールセットを作成することが可能になりました。このAPIでは、Shopify MarketsとB2BプリミティブをPublicationsとPriceListsにリンクして、異なる観客に対する商品提供をカスタマイズすることができます。また、同じAPIを用いて、販売チャネルでの商品公開を管理することも可能です。

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

多様な顧客ニーズに対応するためには、商品の価格設定や公開範囲を一元管理し、自在にカスタマイズできる柔軟性が求められます。しかし、従来のShopify APIでは、それらを一括で管理する機能が限定的であったため、開発者は個別に価格設定や商品公開を調整する必要がありました。

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

新たに導入されたCatalogs APIは、異なる顧客の文脈に応じて商品とその価格を決定するルールセットを作成することができます。これにより、商品の価格設定や公開範囲を一元管理し、自在にカスタマイズすることが可能になります。

実装手順とコード例

GraphQL APIを利用してCatalogs APIを活用する基本的な手順は以下のとおりです。

まず、GraphQL APIを用いてCatalogsを作成します。
次に、作成したCatalogsに対して、価格設定や商品公開のルールを定義します。
最後に、定義したルールを適用したい顧客の文脈（Shopify MarketsやB2Bプリミティブ等）にCatalogsをリンクします。

具体的なコード例は以下のとおりです。


// Catalogsの作成
mutation {
  catalogCreate(input: { name: "My Catalog" }) {
    catalog {
      id
    }
    userErrors {
      field
      message
    }
  }
}

// Catalogsにルールを定義
mutation {
  catalogRuleSetCreate(catalogId: "gid://shopify/Catalog/1", input: { conditions: [{ column: "product_type", relation: "equals", value: "Shirt" }], actions: [{ column: "price", adjustment: { percentage: 10 } }] }) {
    catalogRuleSet {
      id
    }
    userErrors {
      field
      message
    }
  }
}

// Catalogsを顧客の文脈にリンク
mutation {
  catalogPublicationCreate(input: { catalogId: "gid://shopify/Catalog/1", publicationId: "gid://shopify/Publication/1" }) {
    catalogPublication {
      id
    }
    userErrors {
      field
      message
    }
  }
}