Method: hashLists.batchGet

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[]

string

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[]

string (bytes format)

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 states bezeichnet. Jetzt wurde sie aus Gründen der Verständlichkeit 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 an die Clients ein Fehler zurückgegeben.

Insbesondere für BatchGetHashListsRequest können Kunden keine unterschiedlichen desiredHashLength für verschiedene Listen angeben. Ist dies erforderlich, sollte der Client in mehrere BatchGetHashListsRequests aufgeteilt werden.
sizeConstraints

object (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 (HashList)
    }
  ]
}
Felder
hashLists[]

object (HashList)

Die Hash-Listen werden in der Reihenfolge aufgelistet, die in der Anfrage angegeben ist.