3月 05, 2026

カートオブジェクトに新たに追加されたフィールド、deliveryGroups

3月 05, 2026

カートオブジェクトに新たなフィールド「deliveryGroups」を追加

ShopifyのAPI開発者にとって、お客様の購入体験を向上させるための新たな手段が登場しました。GraphQL Admin APIバージョン2022-04にて、カートオブジェクトに新たなフィールド「deliveryGroups」が追加されました。これにより、ログイン状態のお客様のデフォルト配送先に対して、カート内の商品ごとの配送オプションをグループ化することが可能になります。しかし、この新フィールドを適切に活用するためには、その実装方法とベストプラクティスを理解することが重要です。

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

従来のShopifyでは、カート内の商品の配送オプションを一括で設定するしかありませんでした。しかし、商品ごとに配送オプションが異なる場合や、お客様が商品ごとに配送オプションを選びたい場合には、これまでの設定では対応が難しかったのです。

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

新たなフィールド「deliveryGroups」は、この問題を解決します。このフィールドを活用することで、カート内の商品ごとに配送オプションを設定し、それらをグループ化することが可能になります。これにより、お客様は商品ごとに配送オプションを選択することが可能となり、より柔軟な購入体験を提供できます。

実装手順とコード例

まず、ログイン状態のお客様に関連づけられたカートを作成します。これにはcartCreateを使用します。次に、customerCreateを使用して、ログイン状態のお客様を作成します。その後、新たなフィールド「deliveryGroups」をカートオブジェクトに追加することで、商品ごとの配送オプションをグループ化します。

```
mutation {
  cartCreate(input: {buyerIdentity: {email: "customer@example.com", countryCode: "JP"}}) {
    cart {
      id
      deliveryGroups {
        edges {
          node {
            deliveryOptions {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}
```