Method: hashLists.batchGet

Mehrere Hash-Listen gleichzeitig abrufen

Es ist sehr häufig, dass ein Client mehrere Hash-Listen abrufen muss. Die Verwendung dieser Methode ist vorzuziehen, anstatt die reguläre Get-Methode mehrmals zu verwenden.

Dies ist eine standardmäßige Batch-Get-Methode gemäß https://google.aip.dev/231 und 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 jeweiligen Hash-Listen. Es kann sich um eine Bedrohungsliste oder um den globalen Cache handeln. Die Namen dürfen KEINE doppelten Einträge enthalten. Andernfalls erhält der Kunde eine Fehlermeldung.
version[]

string (bytes format)

Die Versionen der Hash-Liste, 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 Versionen angeben, die er zuvor vom Server erhalten hat. Der Client darf diese Bytes NICHT manipulieren.

Der Client muss die Versionen nicht in der Reihenfolge der entsprechenden Listennamen senden. Der Client kann in einer Anfrage weniger oder mehr Versionen senden, als es Namen gibt. Der Client darf jedoch KEINE mehrere Versionen mit demselben Namen senden. Andernfalls erhält der Client eine Fehlermeldung.

Hinweis zur Versionsgeschichte: 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 für Clients ein Fehler zurückgegeben.

Insbesondere ist es für Clients nicht möglich, für verschiedene Listen eine unterschiedliche desiredHashLength anzugeben.BatchGetHashListsRequest Falls erforderlich, sollte der Kunde die BatchGetHashListsRequest in mehrere Teile aufteilen.
sizeConstraints

object (SizeConstraints)

Die Größenbeschränkungen für jede Liste. Wenn sie weggelassen wird, gelten keine Einschränkungen. Die hier aufgeführten Größen beziehen sich auf einzelne Listen und nicht auf alle Listen zusammen.

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 der Reihenfolge, die in der Anfrage angegeben ist.