割り当てとレートの制限

システムの安定性と公平なリソース配分を確保するため、Google Health API は受信 API リクエストにレート制限を適用します。

デフォルトの割り当ては、標準的なユースケースの大部分に対応するように設計されていますが、これらのしきい値を超えるアプリケーションはスロットリングされます。

レート制限と一時的なエラーを処理する

アプリケーションが割り当てられたレート制限を超えると、API はリクエストを拒否し、429 Too Many Requests(RESOURCE_EXHAUSTED)を返します。一時的なサーバーの問題により、503 Service Unavailable(UNAVAILABLE)または 504 Gateway Timeout(DEADLINE_EXCEEDED)が返されることもあります。

負荷を増幅することなくこれらのレスポンスを確実に処理するには、429 RESOURCE_EXHAUSTED、503 UNAVAILABLE、504 DEADLINE_EXCEEDED レスポンスに指数バックオフとランダム ジッターを伴う再試行ロジックを実装します。すぐに再試行すると、輻輳がさらに悪化し、スロットリングやタイムアウトが繰り返される可能性が高くなります。

デフォルトの上限と影響分析

レート制限は、1 日、1 分、ユーザー単位の間隔で評価されます。影響分析では、これらの割り当てが秒間クエリ数(QPS)にどのように変換されるかについて説明します。

指標 デフォルトの上限 QPS 影響分析
プロジェクトごと(1 日あたり) リクエスト 8,640 万件/日 約 1,000 QPS(持続)
プロジェクトごと(1 分あたり) 120,000 リクエスト/分 約 2,000 QPS バースト
ユーザーごと(1 分単位) 300 リクエスト/分 標準: ユーザーあたり 5 QPS
未確認のアプリケーション: 合計最大 250 QPS(ユーザーあたり 2.5 QPS で 100 ユーザーに制限)

OAuth トークン付与のレート制限

Google Cloud では、OAuth トークンの付与にレート制限を適用して、アプリがユーザーをオンボーディングまたは再認証する速度を制御しています。24 時間のスライディング ウィンドウ内で 10,000 人を超えるユーザーの登録または再認証が予想される場合は、事前に割り当ての増加をリクエストしてください。詳細については、OAuth アプリケーションのレート制限をご覧ください。

割り当ての増加をリクエスト

アプリケーションで、デフォルトの割り当てよりも高いスループットが必要な場合は、Google Cloud コンソールから調整をリクエストできます。割り当ての表示と管理をご覧ください。