# バッチジョブ

1 回のファイルアップロードで複数の API リクエストを非同期で処理します。

Batch Jobs API を使用すると、Stripe リソースに対して一括操作を実行できます。レート制限をトリガーする可能性のある操作ごとに個別の API コールを行う代わりに、すべての操作を含むファイルをアップロードして、Stripe に非同期で処理させることができます。1 回限りの移行、一括更新、または多くのリソースの処理が必要な操作に使用します。

## バッチジョブを使用する状況

バッチジョブは、次の用途に適しています。

- **一括移行**: 大量のサブスクリプションを新しい請求モードに移行します。
- **大規模な更新**: 多数のアカウントまたはサブスクリプションを一度に更新します。

バッチジョブは次の用途には適していません。

- 即時の同期応答を必要とする操作。
- 厳しいタイミング要件によるリアルタイム処理
- 単一の非同期コール。

バッチジョブを処理するには、次の手順に従います。

1. [バッチジョブを作成](https://docs.stripe.com/batch-api/create.md#create-a-batch-job)し、ターゲット API エンドポイントを指定します。
2. バッチリクエストを含む[入力ファイルをアップロード](https://docs.stripe.com/batch-api/create.md#upload-the-input-file)します。
3. Webhook またはポーリングを使用して[ジョブステータスを監視](https://docs.stripe.com/batch-api/create.md#monitor-job-status)します。
4. [結果をダウンロード](https://docs.stripe.com/batch-api/create.md#download-the-results)します。

## サポート対象のエンドポイント

Batch Jobs API は、Stripe リソース全体の多くのエンドポイントをサポートしています。各バッチジョブは 1 つのエンドポイントを対象とし、バッチ内のすべてのリクエストはそのエンドポイントに送信されます。

利用可能なエンドポイントの完全なリストについては、[サポート対象のエンドポイント](https://docs.stripe.com/batch-api/supported-endpoints.md)をご覧ください。

## 制限事項

以下の制限事項を確認してください。

- バッチファイルは 5 GB に制限されています。大量のリクエストに対して大きなファイルを処理する必要がある場合は、複数のバッチに分割してください。

- バッチジョブは JSONL (改行区切り JSON) ファイルのみサポートしています。バッチジョブは CSV やその他の形式は受け付けません。

- バッチ内のリクエストは `POST` または `DELETE` のみを使用できます。バッチジョブは `GET` をサポートしていません。

- バッチ内のすべてのリクエストは、同じ API エンドポイントを対象とする必要があります。

- バッチジョブはリクエスト処理の順序を保証しません。

- バッチジョブの最大処理時間は 24 時間です。この時間を超えるジョブは `timeout` ステータスに移行し、一部の結果を利用できます。

- 結果は、ジョブの完了後 7 日間ダウンロードできます。

- アップロード URL はジョブの作成から 5 分後に有効期限が切れます。その後、ジョブは `upload_timeout` に移行するため、新しいジョブを作成する必要があります。

- 事前署名された URL に、直接 HTTP `PUT` リクエストでファイルをアップロードします。