# Die Meter Usage Analytics bieten nun Unterstützung für das Filtern mehrerer Mandanten und Dimensionswerte.

## Das ändert sich

Aktualisiert die Parameter [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) und [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) in der [Meter Usage Analytics API](https://docs.stripe.com/api/billing/meter_usage.md?api-version=2025-11-17.preview), sodass sie anstelle einzelner Zeichenfolgenwerte ein Array von Zeichenfolgen akzeptieren. Diese Änderung ermöglicht es, Nutzungsdaten über mehrere Mandanten- oder Dimensionswerte hinweg mit einem einzigen API-Aufruf zu filtern.

Bisher akzeptierte jeder Filterparameter nur einen einzigen Zeichenfolgenwert, sodass mehrere API-Aufrufe erforderlich waren, um Nutzung für verschiedene Mandanten- oder Dimensionskombinationen abzurufen.

## Warum ist dies eine wichtige Änderung?

Bestehende Integrationen, die einzelne Zeichenfolgenwerte übergeben, erhalten Validierungsfehler, bis sie so aktualisiert werden, dass sie das Array-Format verwenden. Diese grundlegende Änderung ermöglicht flexiblere Filterfunktionen, die die gleichzeitige Abfrage von Nutzungsdaten über mehrere Werte hinweg unterstützen und so die Anzahl der API-Aufrufe reduzieren, die für komplexe Szenarien der Nutzungsberichterstattung erforderlich sind.

## Auswirkungen

Sie müssen Ihre Integration aktualisieren, damit beim [Aufruf von Analysen der gemessenen Nutzung](https://docs.stripe.com/api/billing/meter_usage/create.md?api-version=2025-11-17.preview) von Zählern Arrays von Zeichenfolgen für die Parameter `tenant_filters` und `dimension_filters` übergeben werden. Wenn Ihre Integration derzeit einzelne Zeichenfolgenwerte übergibt, müssen Sie diese in Arrays einbetten.

## Änderungen

#### 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)` |

#### Gehen Sie zu

| 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)` |

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-11-17.preview`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf die neueste Version.
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).