3月 05, 2026

Storefront APIにおけるCartとCartLineの変更点について

3月 05, 2026

Storefront APIにおけるCartとCartLineの変更点

ShopifyのStorefront APIは、ECサイトのショッピングカート機能に対する操作を提供する重要なインターフェースです。しかし、APIがアップデートされることで生じる課題に、開発者は常に直面しています。今回は、2022-07のGraphQL Storefront APIリリースに伴う、Cart と CartLine オブジェクトへの変更点について解説します。

技術的課題と現状分析

既存のショッピングカート関連のAPIでは、価格情報の取得や操作が一部不十分であったため、APIのアップデートが求められていました。具体的には、コストの正確な算出、比較価格の扱い、税金や関税の計算などが課題となっていました。

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

このAPIアップデートにより、以下の変更が加えられました。

attribute フィールドに key 引数が新たに追加されました。
Cart および CartLine における estimatedCost が cost に名称変更されました。
CartCost に subtotalAmountEstimated、totalAmountEstimated、totalTaxAmountEstimated、totalDutyAmountEstimated が追加されました。
CartLineCost における amount が amountPerQuantity に名称変更されました。
CartLineCost における compareAtAmount が compareAtAmountPerQuantity に名称変更されました。

これらの変更により、より細かくコストを計算し、詳細な価格情報を取得することが可能になりました。

実装手順とコード例

例えば、新たに追加された key 引数を使用して、特定の属性を取得するには以下のようなクエリを送信します。


{
  cart(id: "カートID") {
    attribute(key: "特定のキー") {
      key
      value
    }
  }
}

また、新たに追加されたコスト関連のフィールドを取得するには以下のようなクエリを送信します。


{
  cart(id: "カートID") {
    cost {
      subtotalAmountEstimated
      totalAmountEstimated
      totalTaxAmountEstimated
      totalDutyAmountEstimated
    }
  }
}