Method: hashLists.batchGet

Ruft mehrere Hash-Listen gleichzeitig ab.

Es ist sehr häufig, dass ein Client mehrere Hash-Listen abrufen muss. Diese Methode wird gegenüber der mehrmaligen Verwendung der regulären Get-Methode bevorzugt.

Dies ist eine standardmäßige Batch-Get-Methode, wie in https://google.aip.dev/231 definiert. 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[]

string

Erforderlich. Die Namen der einzelnen Hash-Listen. Die Liste KANN eine Bedrohungsliste oder der globale Cache sein. Die Namen DÜRFEN keine Duplikate enthalten. Andernfalls erhält der Client einen Fehler.
version[]

string (bytes format)

Die Versionen der Hashliste, die der Client bereits hat. Wenn der Client die Hash-Listen zum ersten Mal abruft, sollte das Feld leer bleiben. Andernfalls sollte der Client die zuvor vom Server empfangenen Versionen bereitstellen. Der Client DARF diese Bytes NICHT manipulieren.

Der Client muss die Versionen nicht in derselben Reihenfolge wie die entsprechenden Listennamen senden. Der Client sendet in einer Anfrage möglicherweise weniger oder mehr Versionen als Namen vorhanden sind. Der Client darf jedoch nicht mehrere Versionen senden, die demselben Namen entsprechen. Andernfalls erhält er eine Fehlermeldung.

Historischer Hinweis: In Version 4 der API hieß dieser Parameter states. Er wurde zur besseren Verständlichkeit in version umbenannt.

Ein base64-codierter String.
sizeConstraints

object (SizeConstraints)

Die Größenbeschränkungen für jede Liste. Wenn sie weggelassen werden, gibt es keine Einschränkungen. Die Größenangaben beziehen sich auf die einzelnen Listen und sind nicht über alle Listen hinweg aggregiert.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort enthält mehrere Hash-Listen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Felder
hashLists[]

object (HashList)

Die Hash-Listen in derselben Reihenfolge wie in der Anfrage.