Method: hashLists.batchGet

Pobiera kilka list skrótów jednocześnie.

Często zdarza się, że klient potrzebuje kilku list skrótów. Ta metoda jest preferowana w stosunku do wielokrotnego używania zwykłej metody Get.

Jest to standardowa metoda pobierania zbiorczego zdefiniowana na stronie https://google.aip.dev/231, a metoda HTTP to 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 skrótów. Lista MOŻE być listą zagrożeń lub globalną pamięcią podręczną. Nazwy NIE MOGĄ zawierać duplikatów. W przeciwnym razie klient otrzyma błąd.
version[]

string (bytes format)

Wersje listy skrótów, które klient już ma. Jeśli klient pobiera listy skrótów po raz pierwszy, to pole powinno być puste. W przeciwnym razie klient powinien podać 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ż nazw. Klient NIE MOŻE jednak wysyłać wielu wersji o tej samej nazwie. Jeśli to zrobi, otrzyma komunikat o błędzie.

Uwaga historyczna: w wersji 4 interfejsu API ta wartość nazywała się states. Została zmieniona na version, aby była bardziej przejrzysta.

Ciąg zakodowany w formacie Base64.
sizeConstraints

object (SizeConstraints)

Ograniczenia rozmiaru każdej listy. Jeśli pominiesz to pole, nie będzie żadnych ograniczeń. Pamiętaj, że podane tu rozmiary dotyczą poszczególnych list, a nie wszystkich list łącznie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca wiele list skrótów.

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

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

object (HashList)

Listy skrótów są podawane w tej samej kolejności co w żądaniu.