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)

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

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

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

Строка, закодированная в формате Base64.

sizeConstraints

object ( SizeConstraints )

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

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

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

Ответный текст

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

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

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

object ( HashList )

Хэш-списки расположены в том же порядке, что и в запросе.