リクエスト頻度
更新リクエスト
サーバーの過負荷を防ぎ、最適な保護を実現するために、Update API では、クライアントが Web Risk サーバーに URL チェック(hashes.search
)を実行する頻度やローカル データベースを更新する頻度(threatLists.computeDiff
)の時間間隔を設定します。
データの最初のリクエストは、クライアントが開始または起動した後、0〜1 分の間のランダムな間隔で行われる必要があります。後続のリクエストは、最小待機期間またはバックオフモードの制限時間が経過した後にのみ行われます。
最小待機期間
hashes.search レスポンスと threatLists.computeDiff レスポンスの両方に、クライアントが従う必要がある minimumWaitDuration
フィールドがあります。
レスポンスに minimumWaitDuration
フィールドが設定されていない場合、クライアントは必要に応じて更新でき、threatListUpdates
または fullHashes
リクエストを必要な数だけ送信できます。
レスポンスに minimumWaitDuration
フィールドが設定されている場合、クライアントは待機期間の長さよりも高い頻度で更新できません。たとえば、fullHashes
レスポンスに 1 時間の最小待機期間が含まれる場合、ユーザーがハッシュ プレフィックスがローカル データベースと一致する URL にアクセスしても、クライアントはその時間が経過するまで fullHashes
リクエストを送信できません。(クライアントは最小待機期間よりも低い頻度で更新できますが、保護に悪影響を与える可能性があります)
バックオフ モード
推奨されるバックオフの手順については、サービスレベル契約をご覧ください。