Method: hashLists.list
Получение списков хэшей.
В API V5 Google никогда не будет удалять хэш-список, который когда-либо был возвращен этим методом. Это позволяет клиентам отказаться от использования этого метода и просто жестко запрограммировать все нужные им хэш-списки.
Это стандартный метод списка, определенный в https://google.aip.dev/132 , а метод HTTP — GET.
HTTP-запрос
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
pageSize | integer Максимальное количество возвращаемых хэш-списков. Служба может возвращать меньшее значение, чем это значение. Если не указано, сервер выберет размер страницы, который может быть больше, чем количество хэш-списков, поэтому разбиение на страницы не требуется. |
pageToken | string Токен страницы, полученный в результате предыдущего вызова hashLists.list . Предоставьте это, чтобы получить следующую страницу. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответ, содержащий метаданные о хеш-списках.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"hashLists": [
{
object (HashList )
}
],
"nextPageToken": string
} |
Поля |
---|
hashLists[] | object ( HashList ) Хэш-списки располагаются в произвольном порядке. Будут включены только метаданные о хеш-списках, а не содержимое. |
nextPageToken | string Токен, который можно отправить как pageToken для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-10 UTC.
[null,null,["Последнее обновление: 2025-01-10 UTC."],[[["Retrieves a list of available hash lists with metadata, excluding their contents."],["Allows for pagination to retrieve large sets of hash lists using `pageSize` and `pageToken`."],["Google guarantees that hash lists once returned will never be removed, enabling client-side hardcoding."],["Employs standard List method with a GET request to `https://safebrowsing.googleapis.com/v5alpha1/hashLists`."],["Response includes details about each hash list and a token for retrieving subsequent pages if available."]]],["This document details the process for retrieving metadata about hash lists using the V5 API's `hashLists.list` method. It uses an HTTP GET request to `https://safebrowsing.googleapis.com/v5alpha1/hashLists`. Optional query parameters include `pageSize` to limit results and `pageToken` for pagination. The request body must be empty. The response body includes an array of `hashLists` and an optional `nextPageToken` for subsequent pages. The API never removes returned hash lists.\n"]]