Method: hashList.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
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: 2024-04-01 (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: 2024-04-01 (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"]]
