Method: hashLists.batchGet
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получите несколько хэш-списков одновременно.
Очень часто клиенту требуется получить несколько хеш-списков. Использование этого метода предпочтительнее многократного использования обычного метода Get.
Это стандартный пакетный метод Get, определенный в https://google.aip.dev/231 , а метод HTTP также является GET.
HTTP-запрос
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
names[] | string Необходимый. Имена конкретных хэш-списков. Список МОЖЕТ быть списком угроз или глобальным кэшем. Имена НЕ ДОЛЖНЫ содержать дубликаты; если они это сделали, клиент получит сообщение об ошибке. |
version[] | string ( bytes format) Версии хеш-списка, которые уже есть у клиента. Если клиент впервые получает хэш-списки, поле следует оставить пустым. В противном случае клиент должен предоставить версии, ранее полученные от сервера. Клиент НЕ ДОЛЖЕН манипулировать этими байтами. Клиенту не обязательно отправлять версии в том же порядке, что и соответствующие имена списков. Клиент может отправить в запросе меньше или больше версий, чем имён. Однако клиент НЕ ДОЛЖЕН отправлять несколько версий, соответствующих одному и тому же имени; если это так, клиент получит ошибку. Историческая справка: в V4 API это states ; теперь для ясности переименован в version . Строка в кодировке Base64. |
desiredHashLength | enum ( HashLength ) Желаемая длина префикса хеша возвращаемых хешей в байтах. Затем сервер вернет все хеш-префиксы указанной длины. Разные хэш-списки предъявляют разные требования к допустимым значениям поля desiredHashLength . Это можно найти в поле supportedHashLengths в HashListMetadata . Если desiredHashLength не указывает значение в supportedHashLengths , клиентам будет возвращена ошибка. В частности, для BatchGetHashListsRequest клиенты не могут указать разные desiredHashLength для разных списков. Если есть необходимость сделать это, клиент должен разделить на несколько BatchGetHashListsRequest . |
sizeConstraints | object ( SizeConstraints ) Ограничения размера для каждого списка. Если опущено, ограничений нет. Обратите внимание, что размеры здесь указаны для каждого списка, а не агрегированы по всем спискам. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответ, содержащий несколько хэш-списков.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"hashLists": [
{
object (HashList )
}
]
} |
Поля |
---|
hashLists[] | object ( HashList ) Хэш-списки располагаются в том же порядке, что указан в запросе. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-09-24 UTC.
[{
"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": "\u041f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0435 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435: 2024-09-24 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"]],["Последнее обновление: 2024-09-24 UTC."]]