# Meter Usage Analytics ajoute la prise en charge du filtrage de plusieurs tenants et valeurs de dimension ## Nouveautés Met à jour les paramètres [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) et [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) de l’API [Meter Usage Analytics](https://docs.stripe.com/api/billing/meter_usage.md?api-version=2025-11-17.preview) afin d’accepter un tableau de chaînes au lieu d’une seule chaîne. Ce changement vous permet de filtrer les données de consommation effective à travers plusieurs tenants ou valeurs de dimension en un seul appel à l’API. Auparavant, chaque paramètre de filtre n’acceptait qu’une seule valeur de chaîne, ce qui nécessitait plusieurs appels à l’API pour récupérer l’utilisation des données pour différentes combinaisons de locataires ou de dimensions. ## Pourquoi s’agit-il d’une modification majeure ? Les intégrations existantes qui transmettent une seule chaîne reçoivent des erreurs de validation jusqu’à ce qu’elles soient mises à jour pour utiliser le format tableau. Cette modification majeure permet des capacités de filtrage plus flexibles, facilitant les requêtes de données d’utilisation sur plusieurs valeurs simultanément et réduisant le nombre d’appels à l’API nécessaires pour des scénarios complexes de reporting d’utilisation. ## Impact Vous devez mettre à jour votre intégration afin de transmettre des tableaux de chaînes pour les paramètres `tenant_filters` et `dimension_filters` lors de la [récupération des relevés de consommation effective](https://docs.stripe.com/api/billing/meter_usage/create.md?api-version=2025-11-17.preview) du compteur. Si votre intégration transmet actuellement des valeurs de chaîne uniques, vous devez les regrouper dans des tableaux. ## Modifications #### 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)` | ## Mise à niveau #### API REST 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API. - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-11-17.preview` 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Ruby vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Python 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Python vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### PHP 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK PHP vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Java 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Java vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Node vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Go 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Go vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### .NET 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK .NET vers la dernière version. 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).