# 製品カタログインポート API v2 を追加しました

## 新機能

CSV ファイルを使用して商品カタログデータをアップロードするための [Product Catalog Import API v2](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia) が追加されました。新しい [ProductCatalogImport](https://docs.stripe.com/api/v2/commerce/product-catalog-imports/object.md?api-version=2026-04-22.dahlia) リソースを使用して、商品カタログのインポートを作成、取得、一覧表示できるようになりました。

この API は、最大 4GB の CSV ファイルに対応しており、さまざまなフィードタイプ向けに単一ステップのアップロードプロセスを提供します。インポートを作成した後は、以下を含む webhook イベントを通じて進捗を追跡できます。

- [v2.commerce.product_catalog.imports.processing](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.processing) ファイルを受信して処理が開始されたときに送信される
- [v2.commerce.product_catalog.imports.succeeded](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded) インポートが検証エラーなしで完了したときに送信される
- [v2.commerce.product_catalog.imports.succeeded_with_errors](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.succeeded_with_errors) インポートは完了したものの、検証エラーがあるときに送信される
- [v2.commerce.product_catalog.imports.failed](https://docs.stripe.com/api/v2/commerce/product-catalog-imports.md?api-version=2026-04-22.dahlia#v2_product_catalog_imports_event_types-v2.commerce.product_catalog.imports.failed) インポート処理を完了できなかったときに送信される

## 影響

商品カタログを分割したり、個別の API コールでアップロードしたりしなくても、大規模な商品カタログをプログラムでインポートできるようになりました。これにより、初期設定時と一括更新時の両方で、大量の在庫向けの商品カタログを設定するために必要な時間と手順を削減できます。

これらの webhook イベントを使用すると、インポートの完了に応じて動作する自動ワークフローを構築できるため、インポート完了後に在庫の同期やカタログの検証などの後続プロセスをトリガーできます。

詳細については、[エージェントを通じた販売](https://docs.stripe.com/agentic-commerce/for-sellers.md?order-monitoring=webhooks&dashboard-or-api=api#upload-feed)を参照してください。

## 変更点

#### REST API

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Endpoints                    | Change | Resource                                                                                                                                           |
| ---------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve`, `list` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Ruby

|  | Change | Resource                                                                                                                                             |
|  | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                             |
| -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2::Commerce::ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------ |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2::Commerce::ProductCatalogImport` |

#### Python

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### PHP

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Java

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `v2.commerce.ProductCatalogImport` |

#### Node.js

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods              | Change | Resource                                                                                                                                           |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

#### Go

|  | Change | Resource                                                                                                                                         |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|  | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods      | Change | Resource                                                                                                                                         |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Get`, `New` | Added  | [V2CommerceProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2CommerceProductCatalogImport` |

#### .NET

|  | Change | Resource                                                                                                                                           |
|  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

| Methods         | Change | Resource                                                                                                                                           |
| --------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Create`, `Get` | Added  | [V2.Commerce.ProductCatalogImport](/api/v2/commerce/product-catalog-imports/object?api-version=2026-04-22.dahlia#v2_product_catalog_import_object) |

|                                                                                                                                                                                                            | Change | Event type                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- |
| `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` | Added  | `V2.Commerce.ProductCatalogImport` |

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-04-22.dahlia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Ruby SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Python SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. PHP SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Java SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Node SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. Go SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
1. .NET SDK を 最新バージョンにアップグレードします。
1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。