Method: hashLists.batchGet

Получите несколько списков хешей одновременно.

Клиенту очень часто требуется получить несколько списков хешей. Использование этого метода предпочтительнее, чем многократное использование обычного метода Get.

Это стандартный пакетный метод Get, определенный в https://google.aip.dev/231 , а HTTP-метод также называется GET.

HTTP-запрос

GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet

URL-адрес использует синтаксис gRPC Transcoding .

Параметры запроса

Параметры
names[]

string

Обязательно. Имена конкретных списков хэшей. Список МОЖЕТ быть списком угроз или глобальным кэшем. Имена НЕ ДОЛЖНЫ содержать дубликаты; если они есть, клиент получит ошибку.

version[]

string ( bytes format)

Версии списка хэшей, которые уже есть у клиента. Если клиент впервые извлекает списки хэшей, поле следует оставить пустым. В противном случае клиент должен предоставить версии, ранее полученные с сервера. Клиент НЕ ДОЛЖЕН манипулировать этими байтами.

Клиенту не обязательно отправлять версии в том же порядке, что и соответствующие имена списков. Клиент может отправить меньше или больше версий в запросе, чем имен. Однако клиент НЕ ДОЛЖЕН отправлять несколько версий, которые соответствуют одному и тому же имени; если он это сделает, клиент получит ошибку.

Историческая справка: в API V4 это называлось states ; теперь для ясности оно переименовано в version .

Строка в кодировке base64.

sizeConstraints

object ( SizeConstraints )

Ограничения по размеру для каждого списка. Если опущено, ограничений нет. Обратите внимание, что размеры здесь указаны для каждого списка, а не агрегированы по всем спискам.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ, содержащий несколько хэш-списков.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Поля
hashLists[]

object ( HashList )

Списки хешей в том же порядке, что и в запросе.