# ページ分割を追加し、集計請求メーター使用状況データのフィールドを更新します ## 新機能 請求メーターの使用状況の集計データにページ分割を追加し、他の Stripe API との一貫性を保つためにフィールド名を更新します。 ## この変更により互換性が失われる理由 一部のリクエストパラメーターとレスポンスフィールドの名前を変更しました。 リクエストの変更点は次のとおりです。 - `start_time` は [starts_at](https://docs.stripe.com/api/billing/analytics/meter-usage/retrieves.md?api-version=2025-09-30.preview#retrieves_billing_analytics_meter_usage-starts_at) になりました - `end_time` は [ends_at](https://docs.stripe.com/api/billing/analytics/meter-usage/retrieves.md?api-version=2025-09-30.preview#retrieves_billing_analytics_meter_usage-ends_at) になりました - `meters.meter_id` は [meters.meter](https://docs.stripe.com/api/billing/analytics/meter-usage/retrieves.md?api-version=2025-09-30.preview#retrieves_billing_analytics_meter_usage-meters-meter) になりました 応答の変更は次のとおりです。 - `data_refreshed_at` は [refreshed_at](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-refreshed_at) になりました `data` オブジェクトは、ページネーションの詳細を含む [rows](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-rows) 内にネストされます。`data` フィールド内の応答の変更は次のとおりです。 - `bucket_start_time` は [starts_at](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-rows-data-starts_at) になりました - `bucket_end_time` は [ends_at](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-rows-data-ends_at) になりました - `bucket_value` は [value](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-rows-data-value) になりました - `meter_id` は [meter](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?api-version=2025-09-30.preview#billing_analytics_meter_usage_object-rows-data-meter) になりました ## 影響 この API バージョンにアップグレードすると、ページネーション機能を使用して、より多くのメーター使用状況データにアクセスできます。 ## 変更点 #### REST API | Parameters | Change | Resources or endpoints | | ------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ends_at`, `starts_at` | Added | [Billing.Analytics.MeterUsage#retrieve](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `meter` | Added | [Billing.Analytics.MeterUsage#retrieve.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `value` | Added | `Billing.Analytics.MeterUsageRow` | | `bucket_end_time`, `bucket_start_time`, `bucket_value` | Removed | `Billing.Analytics.MeterUsageRow` | | `meter_id` | Removed | [Billing.Analytics.MeterUsage#retrieve.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `end_time`, `start_time` | Removed | [Billing.Analytics.MeterUsage#retrieve](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshed_at`, `rows` | Added | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `data_refreshed_at` | Removed | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### Ruby | Parameters | Change | Resources or methods | | ------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ends_at`, `starts_at` | Added | [Billing::Analytics::MeterUsage::RetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `Billing::Analytics::MeterUsageRow` | | `meter` | Added | [Billing::Analytics::MeterUsage::RetrieveParams::Meter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing::Analytics::MeterUsageRow` | | `value` | Added | `Billing::Analytics::MeterUsageRow` | | `bucket_end_time`, `bucket_start_time`, `bucket_value` | Removed | `Billing::Analytics::MeterUsageRow` | | `meter_id` | Removed | [Billing::Analytics::MeterUsage::RetrieveParams::Meter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing::Analytics::MeterUsageRow` | | `end_time`, `start_time` | Removed | [Billing::Analytics::MeterUsage::RetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshed_at`, `rows` | Added | [Billing::Analytics::MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `data_refreshed_at` | Removed | [Billing::Analytics::MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### Python | Parameters | Change | Resources or methods | | ------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ends_at`, `starts_at` | Added | `Billing.Analytics.MeterUsageRow`, [billing.analytics.MeterUsage.RetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `meter` | Added | `Billing.Analytics.MeterUsageRow`, [billing.analytics.MeterUsage.RetrieveParamsMeter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `value` | Added | `Billing.Analytics.MeterUsageRow` | | `bucket_end_time`, `bucket_start_time`, `bucket_value` | Removed | `Billing.Analytics.MeterUsageRow` | | `meter_id` | Removed | `Billing.Analytics.MeterUsageRow`, [billing.analytics.MeterUsage.RetrieveParamsMeter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `end_time`, `start_time` | Removed | [billing.analytics.MeterUsage.RetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshed_at`, `rows` | Added | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `data_refreshed_at` | Removed | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### PHP | Parameters | Change | Resources or methods | | ------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ends_at`, `starts_at` | Added | `Billing.Analytics.MeterUsageRow`, [Billing\Analytics\MeterUsage.retrieve().$params](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `meter` | Added | `Billing.Analytics.MeterUsageRow`, [Billing\Analytics\MeterUsage.retrieve().$params.meter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `value` | Added | `Billing.Analytics.MeterUsageRow` | | `bucket_end_time`, `bucket_start_time`, `bucket_value` | Removed | `Billing.Analytics.MeterUsageRow` | | `meter_id` | Removed | `Billing.Analytics.MeterUsageRow`, [Billing\Analytics\MeterUsage.retrieve().$params.meter](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `end_time`, `start_time` | Removed | [Billing\Analytics\MeterUsage.retrieve().$params](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshed_at`, `rows` | Added | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `data_refreshed_at` | Removed | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### Java | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `endsAt`, `startsAt` | Added | [billing.analytics.MeterUsageRetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `billing.analytics.MeterUsageRow` | | `meter` | Added | [billing.analytics.MeterUsageRetrieveParams.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `billing.analytics.MeterUsageRow` | | `value` | Added | `billing.analytics.MeterUsageRow` | | `bucketEndTime`, `bucketStartTime`, `bucketValue` | Removed | `billing.analytics.MeterUsageRow` | | `meterId` | Removed | [billing.analytics.MeterUsageRetrieveParams.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `billing.analytics.MeterUsageRow` | | `endTime`, `startTime` | Removed | [billing.analytics.MeterUsageRetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshedAt`, `rows` | Added | [billing.analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `dataRefreshedAt` | Removed | [billing.analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### Node.js | Parameters | Change | Resources or methods | | ------------------------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ends_at`, `starts_at` | Added | [Billing.Analytics.MeterUsageRetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `meter` | Added | [Billing.Analytics.MeterUsageRetrieveParams.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `value` | Added | `Billing.Analytics.MeterUsageRow` | | `bucket_end_time`, `bucket_start_time`, `bucket_value` | Removed | `Billing.Analytics.MeterUsageRow` | | `meter_id` | Removed | [Billing.Analytics.MeterUsageRetrieveParams.meters[]](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `end_time`, `start_time` | Removed | [Billing.Analytics.MeterUsageRetrieveParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `refreshed_at`, `rows` | Added | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `data`, `data_refreshed_at` | Removed | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### Go | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `EndsAt`, `StartsAt` | Added | [BillingAnalyticsMeterUsageParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `BillingAnalyticsMeterUsageRow` | | `Meter` | Added | [BillingAnalyticsMeterUsageMeterParams](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `BillingAnalyticsMeterUsageRow` | | `Value` | Added | `BillingAnalyticsMeterUsageRow` | | `BucketEndTime`, `BucketStartTime`, `BucketValue` | Removed | `BillingAnalyticsMeterUsageRow` | | `MeterID` | Removed | [BillingAnalyticsMeterUsageMeterParams](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview), `BillingAnalyticsMeterUsageRow` | | `EndTime`, `StartTime` | Removed | [BillingAnalyticsMeterUsageParams](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `RefreshedAt`, `Rows` | Added | [BillingAnalyticsMeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `Data`, `DataRefreshedAt` | Removed | [BillingAnalyticsMeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | #### .NET | Parameters | Change | Resources or methods | | ------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `EndsAt`, `StartsAt` | Added | [Billing.Analytics.MeterUsageGetOptions](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview), `Billing.Analytics.MeterUsageRow` | | `Meter` | Added | `Billing.Analytics.MeterUsageRow`, [BillingAnalyticsMeterUsageMeterOptions](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `Value` | Added | `Billing.Analytics.MeterUsageRow` | | `BucketEndTime`, `BucketStartTime`, `BucketValue` | Removed | `Billing.Analytics.MeterUsageRow` | | `MeterId` | Removed | `Billing.Analytics.MeterUsageRow`, [BillingAnalyticsMeterUsageMeterOptions](/api/billing/analytics/meter-usage/retrieves-meters?api-version=2025-09-30.preview) | | `EndTime`, `StartTime` | Removed | [Billing.Analytics.MeterUsageGetOptions](/api/billing/analytics/meter-usage/retrieves?api-version=2025-09-30.preview) | | `RefreshedAt`, `Rows` | Added | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | | `Data`, `DataRefreshedAt` | Removed | [Billing.Analytics.MeterUsage](/api/billing/analytics/meter-usage/object?api-version=2025-09-30.preview) | ## アップグレード #### 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-09-30.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 を [v16.1.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v16.1.0-beta.1)にアップグレードします。 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.2b1](https://github.com/stripe/stripe-python/releases/tag/v13.1.2b1)にアップグレードします。 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-beta.1](https://github.com/stripe/stripe-php/releases/tag/v18.1.0-beta.1)にアップグレードします。 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-beta.1](https://github.com/stripe/stripe-java/releases/tag/v30.1.0-beta.1)にアップグレードします。 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-beta.1](https://github.com/stripe/stripe-node/releases/tag/v19.2.0-beta.1)にアップグレードします。 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-beta.1](https://github.com/stripe/stripe-go/releases/tag/v83.1.0-beta.1)にアップグレードします。 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-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v49.1.0-beta.1)にアップグレードします。 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)について、詳細をご確認ください。 ## 関連する変更 - [自動課税、請求書作成、Checkout Sessions の請求書設定を更新する機能を追加](https://docs.stripe.com/changelog/clover/2025-09-30/checkout-sessions-tax-and-invoice-settings.md) - [サブスクリプションの事前請求を有効にする](https://docs.stripe.com/changelog/clover/2025-09-30/subscriptions-prebilling.md) - [ユニットラベルパラメーターをプロダクトデータハッシュに追加](https://docs.stripe.com/changelog/clover/2025-09-30/add-product-data-unit-label-preview.md)