リクエスト頻度

更新リクエスト

サーバーの過負荷を防ぎ、最適な保護を実現するために、Update API では、クライアントが Web Risk サーバーに URL チェック(hashes.search)を実行する頻度やローカル データベースを更新する頻度(threatLists.computeDiff)の時間間隔を設定します。

データの最初のリクエストは、クライアントが開始または起動した後、0〜1 分の間のランダムな間隔で行われる必要があります。後続のリクエストは、最小待機期間またはバックオフモードの制限時間が経過した後にのみ行われます。

最小待機期間

hashes.search レスポンスthreatLists.computeDiff レスポンスの両方に、クライアントが従う必要がある minimumWaitDuration フィールドがあります。

レスポンスに minimumWaitDuration フィールドが設定されていない場合、クライアントは必要に応じて更新でき、threatListUpdates または fullHashes リクエストを必要な数だけ送信できます。

レスポンスに minimumWaitDuration フィールドが設定されている場合、クライアントは待機期間の長さよりも高い頻度で更新できません。たとえば、fullHashes レスポンスに 1 時間の最小待機期間が含まれる場合、ユーザーがハッシュ プレフィックスがローカル データベースと一致する URL にアクセスしても、クライアントはその時間が経過するまで fullHashes リクエストを送信できません。(クライアントは最小待機期間よりも低い頻度で更新できますが、保護に悪影響を与える可能性があります)

バックオフ モード

推奨されるバックオフの手順については、サービスレベル契約をご覧ください。