# メーター使用量分析により複数のテナントや複数のディメンション値のフィルタリング機能を追加

## 新機能

[Meter Usage Analytics API](https://docs.stripe.com/api/billing/meter_usage.md?api-version=2025-11-17.preview) 内の [tenant_filters](https://docs.stripe.com/api/billing/analytics/meter-usage/retrieves.md?api-version=2025-11-17.preview#retrieves_billing_analytics_meter_usage-meters-tenant_filters) および [dimension_filters](https://docs.stripe.com/api/billing/analytics/meter-usage/retrieves.md?api-version=2025-11-17.preview#retrieves_billing_analytics_meter_usage-meters-dimension_filters) パラメーターが更新され、単一の文字列ではなく文字列の配列を受け付けられるようになりました。この変更により、1 回の API コールで複数のテナントや複数のディメンション値にまたがるメーター使用データをまとめてフィルタリングできるようになります。

以前は、各フィルタパラメーターが受け付ける文字列値は 1 つだけで、テナントやディメンションの組み合わせごとに使用状況データを取得するには、複数の API コールが必要でした。

## なぜこれは、互換性に関わる変更なのでしょうか？

既存の連携は単一の文字列値を渡しているため、配列形式に対応するように更新されるまでは検証エラーが発生します。この互換性に関わる変更により、複数の値にまたがる使用状況データを同時にクエリできる柔軟性の高いフィルタリング機能が利用できるようになります。これにより複雑な使用状況レポートのシナリオで必要となる API コールの回数を減らすことができます。

## 影響

[メーター使用状況分析を取得](https://docs.stripe.com/api/billing/meter_usage/create.md?api-version=2025-11-17.preview)する際に、`tenant_filters` パラメーターと `dimension_filters` パラメーターに文字列の配列を渡すように統合を更新する必要があります。現在、統合で単一の文字列値を渡している場合は、それらを配列で囲む必要があります。

## 変更点

#### REST API

| Field                                                              | Change  | From → to                                          |
| ------------------------------------------------------------------ | ------- | -------------------------------------------------- |
| `Billing.Analytics.MeterUsage#retrieve.meters[].dimension_filters` | Changed | `string → array(string)`, `string → array(string)` |

#### Ruby

| Field                                                                   | Change  | From → to                                          |
| ----------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `Billing::Analytics::MeterUsageRetrieveParams::Meter.dimension_filters` | Changed | `string → array(string)`, `string → array(string)` |

#### Python

| Field                                                               | Change  | From → to                                          |
| ------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `billing.analytics.MeterUsageRetrieveParamsMeter.dimension_filters` | Changed | `string → array(string)`, `string → array(string)` |

#### PHP

| Field                                                                     | Change  | From → to                                          |
| ------------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `Billing\Analytics\MeterUsage.retrieve().$params.meter.dimension_filters` | Changed | `string → array(string)`, `string → array(string)` |

#### Java

| Field                                                                  | Change  | From → to                                          |
| ---------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `billing.analytics.MeterUsageRetrieveParams.meters[].dimensionFilters` | Changed | `string → array(string)`, `string → array(string)` |

#### Node.js

| Field                                                                   | Change  | From → to                                          |
| ----------------------------------------------------------------------- | ------- | -------------------------------------------------- |
| `Billing.Analytics.MeterUsageRetrieveParams.meters[].dimension_filters` | Changed | `string → array(string)`, `string → array(string)` |

#### Go

| Field                                                    | Change  | From → to                                          |
| -------------------------------------------------------- | ------- | -------------------------------------------------- |
| `BillingAnalyticsMeterUsageMeterParams.DimensionFilters` | Changed | `string → array(string)`, `string → array(string)` |

#### .NET

| Field                                                     | Change  | From → to                                          |
| --------------------------------------------------------- | ------- | -------------------------------------------------- |
| `BillingAnalyticsMeterUsageMeterOptions.DimensionFilters` | Changed | `string → array(string)`, `string → array(string)` |

## アップグレード

#### 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-11-17.preview` を含めるように [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)について、詳細をご確認ください。