Method: hashLists.batchGet

Mehrere Hash-Listen gleichzeitig abrufen

Häufig benötigt ein Client mehrere Hash-Listen. Diese Methode wird gegenüber der mehrfachen Verwendung der regulären Get-Methode bevorzugt.

Dies ist eine Standard-Batch-Abrufmethode, wie unter 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 jeweiligen Hash-Listen. Die Liste KANN eine Bedrohungsliste oder der globale Cache sein. Die Namen DÜRFEN KEINE Duplikate enthalten. Wenn er dies getan hat, erhält der Client 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 bereitstellen, die zuvor vom Server empfangen wurden. Der Client DARF diese Bytes NICHT manipulieren.

Der Client muss die Versionen nicht in der gleichen 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 jedoch NICHT mehrere Versionen senden, die dem gleichen Namen entsprechen. Wenn dies der Fall ist, erhält der Client eine Fehlermeldung.

Hinweis: In Version 4 der API hieß dies states. Er wurde jetzt zur Verdeutlichung 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 mit der angegebenen Länge zurück.

Unterschiedliche Hashlisten 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 an Clients zurückgegeben.

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

sizeConstraints

object (SizeConstraints)

Die Größenbeschränkungen für jede Liste. Wenn sie weggelassen wird, 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, die mehrere Hash-Listen enthält.

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 derselben Reihenfolge wie in der Anfrage angegeben.