Method: hashList.get

Получите последнее содержимое хэш-списка. Хэш-список может представлять собой список угроз или список, не представляющий угрозы, например глобальный кэш.

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

HTTP-запрос

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

Параметры пути

Параметры
name

string

Необходимый. Имя этого конкретного хэш-списка. Это может быть список угроз или глобальный кэш.

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

Параметры
version

string ( bytes format)

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

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

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

desiredHashLength

enum ( HashLength )

Желаемая длина префикса хеша возвращаемых хешей в байтах. Затем сервер вернет все хеш-префиксы указанной длины.

Разные хэш-списки предъявляют разные требования к допустимым значениям поля desiredHashLength . Это можно найти в поле supportedHashLengths в HashListMetadata . Если desiredHashLength не указывает значение в supportedHashLengths , будет возвращена ошибка.

sizeConstraints

object ( SizeConstraints )

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

Тело запроса

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

Тело ответа

В случае успеха тело ответа содержит экземпляр HashList .