Method: hashLists.batchGet

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

Często zdarza się, że klient potrzebuje kilku list skrótów. Używanie 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, a metoda HTTP to GET.

Żądanie HTTP

GET https://safebrowsing.googleapis.com/v5/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 odpowiadających 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.