コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
バージョン管理
変更ログ
    概要
    Clover
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
Stripe ダッシュボード
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
プライバシー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
アメリカ
日本語
ホーム開発者向けリソースChangelogClover2025-11-17.preview

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

メーター使用量分析により複数のテナントや複数のディメンション値のフィルタリング機能を追加対応が必要な変更点

新機能

Meter Usage Analytics API 内の tenant_filters および dimension_filters パラメーターが更新され、単一の文字列ではなく文字列の配列を受け付けられるようになりました。この変更により、1 回の API コールで複数のテナントや複数のディメンション値にまたがるメーター使用データをまとめてフィルタリングできるようになります。

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

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

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

影響

メーター使用状況分析を取得する際に、tenant_filters パラメーターと dimension_filters パラメーターに文字列の配列を渡すように統合を更新する必要があります。現在、統合で単一の文字列値を渡している場合は、それらを配列で囲む必要があります。

変更点

フィールド変更する送信元 → 送信先
Billing.Analytics.MeterUsage#retrieve.meters[].dimension_filters変更しました
string → array(string)string → array(string)

アップグレード

  1. Workbench で現在の API バージョンを表示します。
  2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
    • SDK を使用していない場合は、Stripe-Version: 2025-11-17.preview を含めるように API リクエストを更新してください。
  3. Webhook エンドポイントに使用する API バージョンをアップグレードします。
  4. 新しいバージョンに対して、実装内容をテストします。
  5. Connect を使用する場合は、Connect の実装内容をテストします。
  6. Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。

このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc