Method: hashLists.batchGet

Pobieranie wielu list haszy naraz.

Bardzo często zdarza się, że klient potrzebuje kilku list haszowanych adresów. Korzystanie z tej metody jest lepsze niż wielokrotne wywoływanie zwykłej metody Get.

Jest to standardowa metoda zbiorczego pobierania zgodnie ze specyfikacją https://google.aip.dev/231, a metoda HTTP to również GET.

Żądanie HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
names[]

string

Wymagane. nazwy poszczególnych list haszowanych; Może to być lista zagrożeń lub globalny bufor. Nazwy NIE MOGĄ zawierać duplikatów. W przeciwnym razie klient otrzyma komunikat o błędzie.
version[]

string (bytes format)

Wersje listy haszy, które klient już ma. Jeśli klient pobiera listy hasz po raz pierwszy, to pole powinno pozostać puste. W przeciwnym razie klient powinien podać wersje otrzymane wcześniej od serwera. Klient NIE MOŻE manipulować tymi bajtami.

Klient nie musi wysyłać wersji w tej samej kolejności co nazwy odpowiednich list. Klient może wysłać w żądaniu mniej lub więcej wersji niż jest nazw. Klient NIE MOŻE jednak wysyłać wielu wersji o tej samej nazwie. W przeciwnym razie pojawi się błąd.

Uwaga historyczna: w wersji 4 interfejsu API ta metoda miała nazwę states. W celu zwiększenia przejrzystości zmieniliśmy ją na version.

Ciąg znaków zakodowany w formacie Base64.
sizeConstraints

object (SizeConstraints)

Ograniczenia rozmiaru na poszczególnych listach. Jeśli pominiesz to pole, nie będzie żadnych ograniczeń. Pamiętaj, że rozmiary są podawane osobno dla każdej listy, a nie jako suma rozmiarów ze wszystkich list.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca wiele list haszy.

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

Zapis JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Pola
hashLists[]

object (HashList)

listy haszy w takim samym porządku jak w żądaniu;