Uzyskaj wiele list haszów jednocześnie.
Często zdarza się, że klient musi uzyskać wiele list haszujących. Używanie tej metody jest preferowane zamiast wielokrotnego używania 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[] |
To pole jest wymagane. Nazwy konkretnych list skrótów. Może to być lista zagrożeń lub globalna pamięć podręczna. Nazwy NIE MOGĄ zawierać duplikatów. Jeśli tak się stanie, klient otrzyma komunikat o błędzie. |
version[] |
Wersje listy skrótów, które ma już klient. Jeśli klient po raz pierwszy pobiera listy skrótów, to pole powinno pozostać puste. W przeciwnym razie klient powinien dostarczyć wersje otrzymane wcześniej z serwera. Klient NIE MOŻE manipulować tymi bajtami. Klient nie musi wysyłać wersji w tej samej kolejności co odpowiadające im nazwy list. Klient może wysłać w żądaniu mniej lub więcej wersji niż jest nazw. Pamiętaj jednak, że klient NIE MOŻE wysyłać wielu wersji o tej samej nazwie. Jeśli tak było, klient zobaczy komunikat o błędzie. Uwaga historyczna: wersja 4 interfejsu API nazywała się Ciąg zakodowany w standardzie base64. |
desiredHashLength |
Żądana długość prefiksu skrótu dla zwróconych haszów w bajtach. Serwer zwróci wtedy wszystkie prefiksy skrótów o podanej długości. Różne listy skrótów mają różne wymagania dotyczące akceptowanych wartości pola Klienci nie mogą określać innych wartości |
sizeConstraints |
Ograniczenia rozmiaru każdej listy. Jeśli go pominiesz, nie będzie żadnych ograniczeń. Pamiętaj, że podane tu rozmiary odnoszą się do poszczególnych list, a nie z podanych zagregowanych danych 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 ( |
Pola | |
---|---|
hashLists[] |
Kolejność skrótów jest podana w żądaniu. |