Ruft den aktuellen Inhalt einer Hash-Liste ab. Eine Hash-Liste kann entweder eine Bedrohungsliste oder eine Liste ohne Bedrohung sein, z. B. der globale Cache.
Dies ist eine standardmäßige Get-Methode gemäß https://google.aip.dev/131 und 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 |
Erforderlich. Der Name dieser Hash-Liste. Es kann sich um eine Bedrohungsliste oder den globalen Cache handeln. |
Abfrageparameter
| Parameter | |
|---|---|
version |
Die Version der Hash-Liste, die der Client bereits hat. Wenn der Client die Hash-Liste zum ersten Mal abruft, MUSS dieses Feld leer sein. Andernfalls MUSS der Client die Version angeben, die er zuvor vom Server erhalten hat. Der Client darf diese Bytes NICHT manipulieren. Neuerungen in Version 5: In Version 4 der API hieß dieses Feld Ein base64-codierter String. |
desiredHashLength |
Die gewünschte Hash-Präfixlänge der zurückgegebenen Hashes in Byte. Der Server gibt dann alle Hash-Präfixe mit dieser angegebenen Länge zurück. Für verschiedene Hash-Listen gelten unterschiedliche Anforderungen an die zulässigen Werte des Felds |
sizeConstraints |
Die Größenbeschränkungen für die Liste. Wenn sie weggelassen wird, gelten keine Einschränkungen. Einschränkungen werden für alle Geräte mit begrenzter Verarbeitungsleistung, 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.