请求频率
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本文档适用于以下方法:
Update API (v4):
fullHashes.find
Update API (v4):
threatListUpdates.fetch
更新请求
为防止服务器超载并从最佳保护中受益,Update API (v4) 规定了客户端向安全浏览服务器发送请求以执行网址检查 (fullHashes.find) 或更新本地数据库 (threatListUpdates.fetch) 的频率。
对数据的初始请求必须在客户端启动或唤醒后的 0 和 1 分钟之间随机发生。只有在
最短等待时长或
已采用退避模式时间限制
。
最短等待时长
fullHashes.find 响应和
threatListUpdates.fetch 响应
包含客户端必须遵守的 minimumWaitDuration
字段。
如果响应中未设置 minimumWaitDuration
字段,则客户端可以
根据需要随时更新,并尽可能多地发送 threatListUpdates
或 fullHashes
请求
理想选择。
如果响应中的 minimumWaitDuration
字段已设置,则客户端的更新频率不得超过等待时长。例如,如果 fullHashes
响应
包含的最短等待时长为 1 小时,因此客户端不得发送任何 fullHashes
请求
即使用户所访问的网址的哈希前缀与本地
数据库。(请注意,客户端的更新频率可以低于最短等待时长,但
可能会对保护产生负面影响。)
退避模式
自动退避算法适用于
fullHashes.find 响应和
threatListUpdates.fetch 响应。
收到失败 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 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-12。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-12\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-12。"]]