2月 21, 2026

Cart Transform APIの新規および更新された操作について

2月 21, 2026

Cart Transform APIの新規および更新操作

1. 技術的課題の定義

Shopify PlusのEC事業者が直面する一つの課題は、カートの内容を柔軟に制御し、商品バンドルの価格を設定し、カート内の各商品にカスタムタイトルやイメージを設定することです。以前までは、Cart Transform Function APIはパーセンテージベースの調整を行うことが可能でしたが、バンドル内の各コンポーネントの固定価格設定やカスタムタイトル、イメージの設定は行えませんでした。

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

2024年1月バージョンのCart Transform Function APIでは、expand操作を使用してバンドル内の各コンポーネントに固定価格を設定することが可能になりました。さらに、各親ラインアイテム（バンドル）に対してカスタムタイトルとイメージを定義することも可能になりました。これにより、バンドルの価格設定に対する制御が大幅に向上し、アドオン製品としてのバンドルの利用が可能になります。

さらに、新たなupdate操作により、特定のラインアイテムの価格、タイトル、イメージを上書きすることが可能になりました。これにより、カート内のアイテムに対するカスタマイズの自由度が大幅に向上します。update操作はPlusマーチャントのみが利用可能です。

3. 実装手順とコード例

具体的な実装手順としては、まずexpand操作を使用してバンドル内の各コンポーネントに固定価格を設定します。次に、各親ラインアイテム（バンドル）に対してカスタムタイトルとイメージを定義します。最後に、update操作を使用して特定のラインアイテムの価格、タイトル、イメージを上書きします。

// 以下はコード例です
{
  "cart": {
    "items": [
      {
        "id": "ITEM_ID",
        "parent_id": "PARENT_ID",
        "quantity": 1,
        "price": 1000,
        "title": "カスタムタイトル",
        "image": "カスタムイメージURL"
      }
    ]
  },
  "operations": [
    {
      "type": "expand",
      "options": {
        "parent_id": "PARENT_ID",
        "expand_items": [
          {
            "id": "ITEM_ID",
            "quantity": 1,
            "price": 1000,
            "title": "カスタムタイトル",
            "image": "カスタムイメージURL"
          }
        ]
      }
    },
    {
      "type": "update",
      "options": {
        "id": "ITEM_ID",
        "price": 2000,
        "title": "更新後のタイトル",
        "image": "更新後のイメージURL"
      }
    }
  ]
}