システムの安定性と公平なリソース配分を確保するため、Google Health API は受信 API リクエストにレート上限を適用します。
デフォルトの割り当ては、ほとんどの標準的なユースケースに対応するように設計されていますが、これらのしきい値を超えるアプリケーションはスロットリングされます。
レート制限エラーを処理する
アプリケーションが割り当てられたレート制限を超えると、API はリクエストを拒否し、エラー 429 Too Many Requests を返します。エラーを軽減するには、アプリケーションでリクエストの送信をバックオフし、レート制限イベントを適切に処理する再試行ロジックを実装する必要があります。
デフォルトの制限とインパクト分析
レート制限は、1 日、1 分、ユーザーごとの間隔で評価されます。影響分析では、これらの割り当てが秒間クエリ数(QPS)にどのように変換されるかについて説明します。
| 指標 | デフォルトの上限 | QPS インパクト分析 |
|---|---|---|
| プロジェクトごと(1 日) | 8,640 万件のリクエスト / 日 | 約 1,000 QPS(持続的な速度) |
| プロジェクトごと(分単位) | 120,000 リクエスト / 分 | 約 2,000 QPS のバースト |
| ユーザーごと(1 分単位) | 300 リクエスト / 分 | Standard: ユーザー あたり 5 QPS 未確認のアプリケーション: 合計最大 250 QPS(ユーザー 100 人あたり 2.5 QPS で上限設定) |
割り当ての増加をリクエスト
アプリケーションでデフォルトの割り当てよりも高いスループットが必要な場合は、Google Cloud コンソールから調整をリクエストできます。割り当ての表示と管理をご覧ください。