Method: urls.search

wyszukiwanie adresów URL pasujących do znanych zagrożeń; Sprawdzane są wszystkie adresy URL oraz ich sufiksy hosta i wyrażenia przedrostka ścieżki (do określonej głębokości). Oznacza to, że odpowiedź może zawierać adresy URL, które nie zostały uwzględnione w żądaniu, ale są wyrażeniami adresów URL z żądania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
urls[]

string

Wymagane. Adresy URL do wyszukania. Klienci NIE MOGĄ wysyłać więcej niż 50 adresów URL.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zwrócona po wyszukaniu zagrożeń pasujących do określonych adresów URL.

Jeśli nic nie zostanie znalezione, serwer zwróci stan OK (kod stanu HTTP 200) z pustym polem threats, a nie stan NOT_FOUND (kod stanu HTTP 404).

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Pola
threats[]

object (ThreatUrl)

Lista nieuporządkowana. Nieuporządkowana lista znalezionych dopasowań zagrożeń. Każdy wpis zawiera adres URL i typy zagrożeń, które zostały znalezione w tym adresie. Rozmiar listy może być większy niż liczba adresów URL w żądaniu, ponieważ brane są pod uwagę wszystkie wyrażenia adresu URL.
cacheDuration

string (Duration format)

Czas trwania pamięci podręcznej po stronie klienta. Klient MUSI dodać ten czas do bieżącego czasu, aby określić czas wygaśnięcia. Czas wygaśnięcia dotyczy wtedy każdego adresu URL, o który klient zapytał w żądaniu, niezależnie od tego, ile adresów URL zostało zwróconych w odpowiedzi. Nawet jeśli serwer nie zwróci żadnych wyników dla danego adresu URL, klient MUSI zapisać tę informację w pamięci podręcznej.

Jeśli pole threats jest puste, klient MOŻE zwiększyć wartość cacheDuration, aby określić nowy termin ważności, który jest późniejszy niż ten określony przez serwer. W każdym przypadku wydłużony czas trwania pamięci podręcznej nie może przekraczać 24 godzin.

Ważne: klient NIE MOŻE zakładać, że serwer zwróci ten sam czas trwania pamięci podręcznej dla wszystkich odpowiedzi. Serwer MOŻE wybrać różne czasy trwania pamięci podręcznej dla różnych odpowiedzi w zależności od sytuacji.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

ThreatUrl

Adres URL pasujący do co najmniej 1 zagrożenia.

Zapis JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Pola
url

string

Adres URL, którego dotyczy prośba i który został dopasowany do co najmniej 1 zagrożenia.
threatTypes[]

enum (ThreatType)

Lista nieuporządkowana. Nieuporządkowana lista zagrożeń, do których zakwalifikowany jest adres URL.