Method: hashLists.batchGet

Pobierz kilka list haszujących jednocześnie.

Często klient musi otrzymać kilka list haszujących. Użycie tej metody jest lepsze niż wielokrotne używanie zwykłej metody Get.

Jest to standardowa metoda pobierania wsadowego zdefiniowana na stronie https://google.aip.dev/231. 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 konkretnych list haszujących. Lista MOŻE być listą zagrożeń lub globalna pamięć podręczna. Nazwy NIE MOGĄ zawierać duplikatów. Jeśli tak, klient zobaczy błąd.
version[]

string (bytes format)

Wersje listy haszującej klienta. Jeśli klient pobiera listy haszujące po raz pierwszy, to pole powinno być puste. W przeciwnym razie klient powinien dostarczyć wersje odebrane wcześniej z serwera. Klient NIE MOŻE modyfikować tych bajtów.

Klient nie musi wysyłać wersji w tej samej kolejności co na odpowiedniej liście. Klient może wysłać w żądaniu mniej lub więcej wersji niż jest nazw. Jednak klient NIE MOŻE wysyłać wielu wersji o tej samej nazwie; Jeśli tak, wystąpi błąd.

Uwaga historyczna: w wersji 4 interfejsu API nazwa ta nosiła nazwę states. została zmieniona na version, aby była bardziej zrozumiała.

Ciąg zakodowany w formacie base64.
desiredHashLength

enum (HashLength)

Żądana długość prefiksu zwróconych haszów (w bajtach). Serwer zwróci wtedy wszystkie prefiksy skrótu o podanej długości.

Różne listy haszujące mają różne wymagania dotyczące akceptowanych wartości pola desiredHashLength. Można go znaleźć w polu supportedHashLengths w HashListMetadata. Jeśli desiredHashLength nie określi wartości w granicach supportedHashLengths, do klientów zostanie zwrócony błąd.

W przypadku usługi BatchGetHashListsRequest klienci nie mogą określać różnych wartości desiredHashLength dla różnych list. Jeśli zajdzie taka potrzeba, klient powinien podzielić się na kilka elementów typu BatchGetHashListsRequest.
sizeConstraints

object (SizeConstraints)

Ograniczenia dotyczące rozmiaru na każdej liście. Jeśli nazwa zostanie pominięta, nie będzie żadnych ograniczeń. Pamiętaj, że podane tu rozmiary pochodzą z pojedynczej listy, a nie ze wszystkich list.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca wiele list haszujących.

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

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

object (HashList)

Listy haszujące w takiej samej kolejności jak w żądaniu.