Method: hashLists.batchGet

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[]

string

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[]

string (bytes format)

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ę states. Dla jasności została zmieniona na version.

Ciąg zakodowany w standardzie base64.
desiredHashLength

enum (HashLength)

Żą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 desiredHashLength. Można go znaleźć w polu supportedHashLengths w HashListMetadata. Jeśli desiredHashLength nie określi wartości w elemencie supportedHashLengths, klienci zobaczą komunikat o błędzie.

Klienci nie mogą określać innych wartości desiredHashLength dla różnych list w przypadku parametru BatchGetHashListsRequest. Jeśli zachodzi taka potrzeba, podziel klienta na kilka BatchGetHashListsRequest.
sizeConstraints

object (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 (HashList)
    }
  ]
}
Pola
hashLists[]

object (HashList)

Kolejność skrótów jest podana w żądaniu.