Примечания к выпуску
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Версия 4.0
Следующие обновления и новые функции включены в API безопасного просмотра (v4).
API поиска (v4)
Что то же самое:
- Клиенты API по-прежнему напрямую запрашивают сервер Google Safe Browsing и списки безопасного просмотра.
Что отличается:
- Метод HTTP
GET
больше не поддерживается. Вместо этого используйте метод HTTP POST
. -
key
параметр теперь является единственным параметром, необходимым в URL-адресе запроса HTTP POST
. - Формат запроса и ответа HTTP
POST
изменился. Обычный текст больше не поддерживается. Вместо этого используйте JSON.
Обновление API (v4)
Что то же самое:
- API по-прежнему заставляет клиентов периодически обновлять хэш-префиксы SHA256 в списках локальной базы данных.
- API также имеет аналогичный запрос на получение полноразмерных хэшей SHA256, когда клиент сталкивается с конфликтом хэш-префиксов.
Что отличается:
-
key
параметр теперь является единственным параметром, необходимым в URL-адресе запроса HTTP POST
. - Формат запроса и ответа HTTP
POST
изменился. Обычный текст больше не поддерживается. Вместо этого используйте JSON. - Способ кодирования обновлений изменился. Вместо обслуживания дополнительных и дополнительных фрагментов API теперь обслуживает различия, используя простой протокол управления версиями. Клиент отправляет на сервер свое текущее состояние вместе с запрошенными обновлениями. Сервер отвечает новым состоянием клиента и дифференциалом, чтобы полностью обновить клиент.
- Чтобы обеспечить минимальную потерю защиты при учете ограничений клиента, API предоставляет списки приоритетных угроз. Ресурсы устройства, пропускная способность, геолокация и другие сигналы используются для передачи данных об угрозах с наивысшим приоритетом каждому клиенту.
ThreatLists.list Метод
Новый метод threatLists.list
возвращает список списков безопасного просмотра, доступных в настоящее время для поиска или загрузки.
Коды состояния
Коды состояния HTTP, генерируемые сервером в ответ на запрос HTTP POST
, изменились.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[[["Прост для понимания","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"]],["Последнее обновление: 2025-07-25 UTC."],[[["Safe Browsing APIs v4 transitions to using HTTP `POST` requests with JSON format, replacing the previous `GET` method and plain text format."],["The Update API v4 introduces a new diff-based update system for efficient threat list management and prioritizes threat lists based on client context."],["A new `threatLists.list` method enables retrieval of available Safe Browsing lists."],["The `key` parameter is now the sole requirement in HTTP `POST` request URLs for both Lookup and Update APIs."],["Updated HTTP status codes reflect the changes in request and response handling within the v4 APIs."]]],["Safe Browsing API (v4) updates include changes to both the Lookup and Update APIs. The `GET` method is replaced by `POST`, and plain text is replaced by JSON for requests and responses. The `key` parameter is now the sole required URL parameter. Updates are now encoded as diffs using a versioning protocol. The API serves prioritized threat lists based on client constraints. A new `threatLists.list` method lists available Safe Browsing lists, and HTTP status codes have been revised.\n"]]