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/v5alpha1/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 in version per maggiore chiarezza.

Una stringa con codifica Base64.
desiredHashLength
(deprecated)

enum (HashLength)

La lunghezza in byte del prefisso dell'hash desiderato degli hash restituiti. Il server restituirà quindi tutti i prefissi degli hash di questa lunghezza specificata.

Elenchi di hash diversi hanno requisiti diversi per i valori accettabili del campo desiredHashLength. Puoi trovarlo nel campo supportedHashLengths in HashListMetadata. Se desiredHashLength non specifica un valore all'interno di supportedHashLengths, ai clienti verrà restituito un errore.

In particolare, per BatchGetHashListsRequest non è possibile per i clienti specificare un valore diverso per elenchi diversi.desiredHashLength Se è necessario, il cliente deve essere suddiviso in più BatchGetHashListsRequest.
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.