Method: hashList.get

Pobierz najnowsze treści z listy haszy. Lista haszy może być listą zagrożeń lub niegroźnych treści, np. globalnym pamięcią podręczną.

Jest to standardowa metoda Get zdefiniowana w https://google.aip.dev/131, a 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

Wymagany. Nazwa tej konkretnej listy haszowanej. Może to być lista zagrożeń lub globalny bufor.

Parametry zapytania

Parametry
version

string (bytes format)

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

Co nowego w wersji 5: w wersji 4 interfejsu API ta wartość miała nazwę states. W celu zwiększenia przejrzystości została ona zmieniona na version.

Ciąg znaków zakodowany w formacie Base64.
desiredHashLength
(deprecated)

enum (HashLength)

Pożądana długość prefiksu hasha zwracanych haszy w bajtach. Serwer zwróci wszystkie prefiksy skrótu o podanej długości.

Różne listy haszy mają różne wymagania dotyczące dozwolonych wartości pola desiredHashLength. Znajdziesz go w polu supportedHashLengths w sekcji HashListMetadata. Jeśli desiredHashLength nie określa wartości w supportedHashLengths, zwracany jest błąd.
sizeConstraints

object (SizeConstraints)

Ograniczenia rozmiaru listy. Jeśli pominiesz to pole, nie będzie żadnych ograniczeń. Ograniczenia zalecamy na wszystkich urządzeniach o ograniczonej mocy obliczeniowej, przepustowości lub pojemności pamięci masowej.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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