Method: hashLists.batchGet

Ricevi più elenchi di hash contemporaneamente.

È molto comune che un cliente debba ottenere più elenchi di hash. L'utilizzo di questo metodo è preferibile all'utilizzo ripetuto del metodo Get standard.

Si tratta di un metodo Get batch standard come definito da https://google.aip.dev/231 e il metodo HTTP è anche GET.

Richiesta HTTP

GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
names[]

string

Obbligatorio. I nomi dei singoli elenchi di hash. L'elenco POTREBBE essere un elenco di minacce o la cache globale. I nomi NON DEVONO contenere duplicati. In caso contrario, il cliente riceverà un errore.
version[]

string (bytes format)

Le versioni dell'elenco di hash già in possesso del client. Se è la prima volta che il client recupera gli elenchi di hash, il campo deve essere lasciato vuoto. In caso contrario, il client deve fornire le versioni ricevute in precedenza dal server. Il client NON DEVE manipolare questi byte.

Il cliente non deve inviare le versioni nello stesso ordine dei nomi degli elenchi corrispondenti. Il cliente può inviare in una richiesta meno o più versioni rispetto al numero di nomi. Tuttavia, il client NON DEVE inviare più versioni corrispondenti allo stesso nome, altrimenti riceverà un errore.

Nota storica: nella versione 4 dell'API, questo valore si chiamava states; ora è stato rinominato version per maggiore chiarezza.

Una stringa con codifica Base64.
sizeConstraints

object (SizeConstraints)

I limiti di dimensione per ogni elenco. Se omesso, non ci sono vincoli. Tieni presente che le dimensioni riportate si riferiscono a ciascun elenco e non sono aggregate in tutti gli elenchi.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta contenente più elenchi di hash.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Campi
hashLists[]

object (HashList)

Gli hash sono elencati nello stesso ordine indicato nella richiesta.