リクエスト頻度
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このドキュメントは、次のメソッドに適用されます。
Update API(v4):
fullHashes.find
Update API(v4):
threatListUpdates.fetch
更新リクエスト
サーバーの過負荷を防ぎ、最適な保護のメリットを得るため、Update API(v4)では
クライアントがセーフ ブラウジング サーバーにリクエストを送信できる頻度
URL チェックを実行
(fullHashes.find)
ローカルデータベースを更新するか
(threatListUpdates.fetch).
最初のデータ リクエストは、リクエストから 0 ~ 1 分の間のランダムな間隔で
起動またはスリープ解除します。後続のリクエストは、
最小待機時間
バックオフ モードの時間制限が
表示されます。
最小待機期間
また、
fullHashes.find レスポンスと
threatListUpdates.fetch レスポンス
クライアントが従う必要がある minimumWaitDuration
フィールドがある。
レスポンスで minimumWaitDuration
フィールドが設定されていない場合、クライアントは
必要な頻度で更新し、threatListUpdates
または fullHashes
リクエストを必要なだけ送信します。
実現できます。
レスポンスで minimumWaitDuration
フィールドが設定されている場合、クライアントは
待機時間の長さよりも頻繁に更新されます。たとえば、fullHashes
レスポンスが
最小待機時間が 1 時間の場合、クライアントは fullHashes
リクエストを送信してはいけません。
その 1 時間が経過するまでは、ユーザーがアクセスした URL のハッシュ接頭辞が
データベースです(クライアントは更新頻度が最小待機時間より少ないこともありますが、
保護に悪影響を及ぼす可能性があります)。
バックオフ モード
自動バックオフは、
fullHashes.find レスポンスと
threatListUpdates.fetch レスポンス。
失敗した HTTP レスポンス(つまり、HTTP レスポンス以外の HTTP ステータス コード)を
200 OK
など)をバックオフ モードに切り替える必要があります。バックオフ モードになると、クライアントは計算された時間を
サーバーに再度リクエストを送信できるようになるまでに時間がかかることが予想されます。
クライアントは、次の数式を使用してバックオフ時間を計算する必要があります。
MIN((2N-1 * 15 minutes) * (RAND + 1), 24 hours)
N は、クライアントで連続して失敗したリクエストの数に対応します。
(最初のリクエストの失敗後は N=1 から開始します)。RAND は 0 ~ 1 の乱数
更新に失敗するたびに
それを選択する必要があるからです
クライアントは、正常な HTTP レスポンスを受信したらバックオフ モードを終了し、その後、
最小待機時間
指定します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThe Google Safe Browsing Update API (v4) enforces request frequency limits to prevent server overload and maintain optimal protection.\u003c/p\u003e\n"],["\u003cp\u003eClients should adhere to the \u003ccode\u003eminimumWaitDuration\u003c/code\u003e field provided in API responses to determine update frequency.\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003eminimumWaitDuration\u003c/code\u003e field is not set, clients can update as frequently as needed; if set, updates should not exceed the specified duration.\u003c/p\u003e\n"],["\u003cp\u003eUpon receiving unsuccessful HTTP responses, clients must enter back-off mode, delaying subsequent requests using a calculated time duration formula.\u003c/p\u003e\n"],["\u003cp\u003eAfter a successful response, clients exit back-off mode and resume following the \u003ccode\u003eminimumWaitDuration\u003c/code\u003e guidelines for updates.\u003c/p\u003e\n"]]],["The Update API v4's `fullHashes.find` and `threatListUpdates.fetch` methods require clients to adhere to request time intervals. Initial requests must be sent within 0-1 minutes of startup, and subsequent requests must observe the `minimumWaitDuration` or `back-off mode`. If `minimumWaitDuration` isn't set, clients can update freely; if set, they must wait for the specified duration. Unsuccessful HTTP responses trigger back-off mode, using a formula to determine the wait time, until a successful response occurs.\n"],null,["# Request Frequency\n\nThis document applies to the following methods:\n- [Update API (v4)](/safe-browsing/v4/update-api): [fullHashes.find](/safe-browsing/v4/update-api#example-fullHashesfind)\n- [Update API (v4)](/safe-browsing/v4/update-api): [threatListUpdates.fetch](/safe-browsing/v4/update-api#example-threatListUpdatesfetch)\n\nUpdate requests\n---------------\n\n- To prevent server overload and to benefit from optimal protection, the Update API (v4) imposes time intervals for how often a client can send requests to the Safe Browsing server to perform URL checks ([fullHashes.find](/safe-browsing/v4/update-api#example-fullhashesfind)) or to update the local database ([threatListUpdates.fetch](/safe-browsing/v4/update-api#example-threatlistupdatesfetch)).\n- The initial request for data must happen at a random interval between 0 and 1 minutes after the client starts or wakes up. Subsequent requests can happen only after the [minimum wait duration](/safe-browsing/v4/request-frequency#minimum-wait-duration) or [back-off mode](/safe-browsing/v4/request-frequency#back-off-mode) time limit has been observed.\n\nMinimum wait duration\n---------------------\n\n- Both the [fullHashes.find response](/safe-browsing/v4/update-api#http-post-response_2) and [threatListUpdates.fetch response](/safe-browsing/v4/update-api#http-post-response) have a `minimumWaitDuration` field that clients must obey.\n- If the `minimumWaitDuration` field **is not set** in the response, clients can update as frequently as they want and send as many `threatListUpdates` or `fullHashes` requests as they want.\n- If the `minimumWaitDuration` field **is set** in the response, clients cannot update more frequently than the length of the wait duration. For example, if a `fullHashes` response contains a minimum wait duration of 1 hour, the client must not send send any `fullHashes` requests until that hour passes, even if the user is visiting a URL whose hash prefix matches the local database. (Note that clients can update less frequently than the minimum wait duration but this may negatively affect protection.)\n\nBack-off mode\n-------------\n\n- Automatic back-off applies to both the [fullHashes.find response](/safe-browsing/v4/update-api#http-post-response_2) and [threatListUpdates.fetch response](/safe-browsing/v4/update-api#http-post-response).\n- Clients that receive an unsuccessful HTTP response (that is, any HTTP status code other than `200 OK`) must enter back-off mode. Once in back-off mode, clients must wait the computed time duration before they can issue another request to the server.\n- Clients must use the following formula to compute the back-off time duration: \n\n```scdoc\nMIN((2N-1 * 15 minutes) * (RAND + 1), 24 hours)\n```\n- N corresponds to the number of consecutive, unsuccessful requests that the client experiences (starting with N=1 after the first unsuccessful request). RAND is a random number between 0 and 1 that needs to be picked after every unsuccessful update.\n- Once a client receives a successful HTTP response, the client must exit back-off mode and follow the [minimum wait duration](/safe-browsing/v4/request-frequency#minimum-wait-duration) specified above."]]