# Events v2 にイベントタイプによるフィルタリングのサポートを追加

## 新機能

[events v2](https://docs.stripe.com/api/v2/core/events.md?api-version=2025-10-29.clover) では、[types](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-types) パラメーターを使用してタイプ別にイベントをフィルタリングできるようになりました。[object_id](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-object_id) パラメーターはオプションになりました。

## 影響

`types` パラメーターを使用して特定のイベントタイプで、また [created.gt](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-created-gt)、[created.gte](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-created-gte)、[created.lt](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-created-lt)、[created.lte](https://docs.stripe.com/api/v2/core/events/list.md?api-version=2025-10-29.clover#v2_list_events-created-lte) パラメーターを使用して時間範囲でイベントをフィルタリングできるようになりました。`object_id` パラメーターがオプションになり、特定のオブジェクトを指定せずにイベントを一覧表示できるようになりました。

## 変更点

#### REST API

| Parameters         | Change | Resources or endpoints |
| ------------------ | ------ | ---------------------- |
| `created`, `types` | Added  | `V2.Event#list`        |

| Field                     | Change  | From → to             |
| ------------------------- | ------- | --------------------- |
| `V2.Event#list.object_id` | Changed | `required → optional` |

#### Ruby

| Parameters         | Change | Resources or methods    |
| ------------------ | ------ | ----------------------- |
| `created`, `types` | Added  | `V2::Event::ListParams` |

| Field                             | Change  | From → to             |
| --------------------------------- | ------- | --------------------- |
| `V2::Event::ListParams.object_id` | Changed | `required → optional` |

#### Python

| Parameters         | Change | Resources or methods  |
| ------------------ | ------ | --------------------- |
| `created`, `types` | Added  | `v2.Event.ListParams` |

| Field                           | Change  | From → to             |
| ------------------------------- | ------- | --------------------- |
| `v2.Event.ListParams.object_id` | Changed | `required → optional` |

#### PHP

| Parameters         | Change | Resources or methods     |
| ------------------ | ------ | ------------------------ |
| `created`, `types` | Added  | `V2\Event.all().$params` |

| Field                              | Change  | From → to             |
| ---------------------------------- | ------- | --------------------- |
| `V2\Event.all().$params.object_id` | Changed | `required → optional` |

#### Java

| Parameters         | Change | Resources or methods |
| ------------------ | ------ | -------------------- |
| `created`, `types` | Added  | `v2.EventListParams` |

| Field                         | Change  | From → to             |
| ----------------------------- | ------- | --------------------- |
| `v2.EventListParams.objectId` | Changed | `required → optional` |

#### Node.js

| Parameters         | Change | Resources or methods |
| ------------------ | ------ | -------------------- |
| `created`, `types` | Added  | `V2.EventListParams` |

| Field                          | Change  | From → to             |
| ------------------------------ | ------- | --------------------- |
| `V2.EventListParams.object_id` | Changed | `required → optional` |

#### 移動

| Parameters         | Change | Resources or methods |
| ------------------ | ------ | -------------------- |
| `Created`, `Types` | Added  | `V2EventListParams`  |

#### .NET

| Parameters         | Change | Resources or methods  |
| ------------------ | ------ | --------------------- |
| `Created`, `Types` | Added  | `V2.EventListOptions` |

## アップグレード

#### 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: 2025-10-29.clover` を含めるように [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 を [v17.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.1.0)にアップグレードします。
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 を [v13.1.0](https://github.com/stripe/stripe-python/releases/tag/v13.1.0)にアップグレードします。
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 を [v18.1.0](https://github.com/stripe/stripe-php/releases/tag/v18.1.0)にアップグレードします。
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 を [v30.1.0](https://github.com/stripe/stripe-java/releases/tag/v30.1.0)にアップグレードします。
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 を [v19.2.0](https://github.com/stripe/stripe-node/releases/tag/v19.2.0)にアップグレードします。
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 を [v83.1.0](https://github.com/stripe/stripe-go/releases/tag/v83.1.0)にアップグレードします。
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 を [v49.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.1.0)にアップグレードします。
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)について、詳細をご確認ください。