Rufen Sie mehrere Hash-Listen gleichzeitig ab.
Häufig benötigt ein Client mehrere Hash-Listen. Diese Methode ist gegenüber der regulären Get-Methode besser geeignet, als mehrere Male zu verwenden.
Dies ist eine Standard-Batch-Get-Methode gemäß https://google.aip.dev/231. Die HTTP-Methode ist ebenfalls GET.
HTTP-Anfrage
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
names[] |
Erforderlich. Die Namen der jeweiligen Hash-Listen. Die Liste KANN eine Bedrohungsliste oder der globale Cache sein. Die Namen DÜRFEN KEINE Duplikate enthalten. Andernfalls erhält der Client eine Fehlermeldung. |
version[] |
Die Versionen der Hash-Liste, die der Client bereits hat. Wenn der Client zum ersten Mal die Hash-Listen abruft, sollte das Feld leer bleiben. Andernfalls sollte der Client die zuvor vom Server erhaltenen Versionen bereitstellen. Der Client DARF diese Byte NICHT bearbeiten. Der Client muss die Versionen nicht in derselben Reihenfolge wie die entsprechenden Listennamen senden. Der Client sendet möglicherweise weniger oder mehr Versionen in einer Anfrage, als Namen vorhanden sind. Der Client DARF NICHT jedoch mehrere Versionen senden, die demselben Namen entsprechen. Andernfalls erhält der Client eine Fehlermeldung. Hinweis: In Version 4 der API wurde dies als 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 in der angegebenen Länge zurück. Unterschiedliche Hash-Listen haben unterschiedliche Anforderungen an die zulässigen Werte des Felds Insbesondere für |
sizeConstraints |
Die Größenbeschränkungen für jede Liste. Bei Auslassung gibt es keine Einschränkungen. Die Größen hier gelten pro Liste und nicht für alle Listen zusammengefasst. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Antwort mit mehreren Hash-Listen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"hashLists": [
{
object ( |
Felder | |
---|---|
hashLists[] |
Die Hash-Listen werden in der Reihenfolge aufgelistet, die in der Anfrage angegeben ist. |