Method: hashList.get

Pobierz najnowszą zawartość listy skrótów. Lista skrótów może obejmować listę zagrożeń lub listę niebezpieczną, na przykład globalną pamięć podręczną.

Jest to standardowa metoda get zgodnie z definicją podaną na stronie https://google.aip.dev/131. Metoda HTTP to również GET.

Żądanie HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

To pole jest wymagane. Nazwa tej konkretnej listy skrótów. Może to być lista zagrożeń lub globalna pamięć podręczna.

Parametry zapytania

Parametry
version

string (bytes format)

Wersja listy skrótów, którą klient już ma. Jeśli klient po raz pierwszy pobiera listę skrótów, to pole MUSI pozostać puste. W przeciwnym razie klient POWINIEN dostarczyć wersję otrzymaną wcześniej z serwera. Klient NIE MOŻE manipulować tymi bajtami.

Co nowego w wersji 5: w wersji 4 interfejsu API nazwaliśmy ją states, a teraz została zmieniona na version, aby była bardziej zrozumiała.

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, zostanie zwrócony błąd.
sizeConstraints

object (SizeConstraints)

Ograniczenia rozmiaru listy. Jeśli go pominiesz, nie będzie żadnych ograniczeń. Ograniczenia są zalecane w przypadku wszystkich urządzeń, które mają ograniczoną moc obliczeniową, przepustowość lub miejsce na dane.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu HashList.