Method: hashList.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 |
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 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 states. Es wurde aus Gründen der Klarheit in version umbenannt. Ein base64-codierter String.
|
desiredHashLength
(deprecated) |
enum (HashLength)
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 desiredHashLength. Sie finden ihn in HashListMetadata im Feld supportedHashLengths. Wenn für desiredHashLength kein Wert innerhalb von supportedHashLengths angegeben ist, wird ein Fehler zurückgegeben.
|
sizeConstraints |
object (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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-06 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-03-06 (UTC)."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]
