Method: hashList.get

Ruft den neuesten Inhalt einer Hash-Liste ab. Eine Hash-Liste kann entweder nach einer Bedrohungsliste oder einer Liste ohne Bedrohungen, wie dem globalen Cache, sortiert werden.

Dies ist eine standardmäßige Get-Methode gemäß der Definition unter https://google.aip.dev/131. Die HTTP-Methode ist ebenfalls GET.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name dieser Hash-Liste. Es kann sich um eine Bedrohungsliste oder den globalen Cache handeln.

Abfrageparameter

Parameter
version

string (bytes format)

Die Version der Hash-Liste, die der Client bereits hat. Wenn der Client zum ersten Mal die Hash-Liste abruft, MUSS dieses Feld leer bleiben. Andernfalls SOLLTE der Client die zuvor vom Server erhaltene Version angeben. Der Client DARF diese Byte NICHT bearbeiten.

Neu in Version 5: In Version 4 der API wurde die Bezeichnung states genannt. Zur Verdeutlichung wurde sie jetzt in version umbenannt.

Ein base64-codierter String.

desiredHashLength

enum (HashLength)

Die gewünschte Hash-Präfixlänge der zurückgegebenen Hashes in Byte. Der Server gibt dann alle Hash-Präfixe in der angegebenen Länge zurück.

Unterschiedliche Hash-Listen haben unterschiedliche Anforderungen an die zulässigen Werte des Felds desiredHashLength. Diese finden Sie im Feld supportedHashLengths in HashListMetadata. Wenn desiredHashLength keinen Wert innerhalb von supportedHashLengths angibt, wird ein Fehler zurückgegeben.

sizeConstraints

object (SizeConstraints)

Die Größenbeschränkungen der Liste. Bei Auslassung gibt es keine Einschränkungen. Einschränkungen werden für alle Geräte mit eingeschränkter Rechenleistung, Bandbreite oder Speicher empfohlen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von HashList.