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 )

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