Method: urls.search

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

HTTP-запрос

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

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

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

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

string

Обязательно. URL-адреса для поиска. Клиенты НЕ ДОЛЖНЫ отправлять более 50 URL-адресов.

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

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

Тело ответа

Ответ возвращен после поиска угроз, соответствующих указанным URL-адресам.

Если ничего не найдено, сервер вернет статус OK (код статуса HTTP 200) с пустым полем threats , а не вернет статус NOT_FOUND (код статуса HTTP 404).

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

JSON-представление 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Поля
threats[]

object ( ThreatUrl )

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

cacheDuration

string ( Duration format)

Продолжительность кэширования на стороне клиента. Клиент ДОЛЖЕН прибавить эту продолжительность к текущему времени, чтобы определить срок действия. Срок действия применяется к каждому URL-адресу, указанному клиентом в запросе, независимо от количества URL-адресов, возвращенных в ответе. Даже если сервер не возвращает совпадений для конкретного URL-адреса, этот факт ДОЛЖЕН быть закэширован клиентом.

Только в том случае, если поле threats пусто, клиент МОЖЕТ увеличить cacheDuration , чтобы определить новый срок действия, более поздний, чем указанный сервером. В любом случае увеличенный срок действия кэша не должен превышать 24 часов.

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

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « s ». Пример: "3.5s" .

ThreatUrl

URL-адрес, соответствующий одной или нескольким угрозам.

JSON-представление 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Поля
url

string

Запрошенный URL-адрес, соответствующий одной или нескольким угрозам.

threatTypes[]

enum ( ThreatType )

Неупорядоченный список. Неупорядоченный список угроз, к которым относится URL.