Method: hashLists.batchGet

Pobieranie wielu list haszy naraz.

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

Jest to standardowa metoda zbiorczego pobierania zgodnie z definicją w https://google.aip.dev/231, a metoda HTTP to też GET.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
names[]

string

Wymagany. nazwy poszczególnych list haszowanych; Lista MOŻE być listą zagrożeń lub globalnym buforem. 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 haszy po raz pierwszy, 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 takim samym porządku jak 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.
desiredHashLength
(deprecated)

enum (HashLength)

Pożądana długość prefiksu hasha zwracanych haszy w bajtach. Serwer zwróci wszystkie prefiksy skrótu o podanej długości.

Różne listy haszy mają różne wymagania dotyczące dozwolonych wartości pola desiredHashLength. Znajdziesz go w polu supportedHashLengths w sekcji HashListMetadata. Jeśli desiredHashLength nie określa wartości w ramach supportedHashLengths, klientom zostanie zwrócony błąd.

W szczególności w przypadku BatchGetHashListsRequest klienci nie mogą określać różnych wartości desiredHashLength dla różnych list. W takim przypadku klienta należy podzielić na kilka BatchGetHashListsRequest.
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 są agregowane w przypadku 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 podano w żądaniu;