2月 21, 2026

CartLinesUpdateミューテーションで行プロパティを保持する方法

2月 21, 2026

CartLinesUpdate mutationで行属性を保持する方法

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

ShopifyのStorefront GraphQL APIでは、CartLinesUpdateミューテーションを使用してカートの行を更新することができます。しかし、従来の動作では、attributesパラメータを省略したりnullに設定した場合、行の属性がリセットされてしまいました。これは、カート内の製品に対する特殊な設定や特性を保持するための重要な機能であり、これがリセットされると、ユーザーエクスペリエンスに悪影響を及ぼす可能性があります。

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

Shopifyはこの問題を解決するために、新たなアップデートをリリースしました。このアップデートにより、attributesパラメータが省略された場合やnullに設定された場合でも、既存の行の属性が保持されるようになりました。この変更により、行の属性を意図的にリセットしたい場合は、空のハッシュ{ }を渡すことで可能となります。

3. 実装手順とコード例

この新しい動作を利用するためには、CartLinesUpdateミューテーションを以下のように呼び出すことができます：


mutation {
  cartLinesUpdate(cartId: "cart_id", lines: [{ id: "line_id", variantId: "variant_id", quantity: 1, attributes: null }]) {
    userErrors {
      field
      message
    }
    cart {
      id
      lines(first: 5) {
        edges {
          node {
            id
            quantity
            attributes {
              key
              value
            }
          }
        }
      }
    }
  }
}

この例では、attributesパラメータにnullを設定していますが、このパラメータを省略しても同じ結果が得られます。