Method: hashLists.batchGet

Ottieni più elenchi di hash contemporaneamente.

È molto comune per un cliente avere bisogno di più elenchi di hash. L'utilizzo di questo metodo è preferibile rispetto all'uso ripetuto del metodo Get standard.

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
names[]

string

obbligatorio. I nomi di specifici elenchi di hash. L’elenco POTREBBE essere un elenco di minacce, o potrebbe essere la Cache globale. I nomi NON DEVONO contenere duplicati; se lo fossero, il client riceverà un errore.

version[]

string (bytes format)

Le versioni dell'elenco di hash già in uso nel 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 client non deve necessariamente inviare le versioni nello stesso ordine dei nomi degli elenchi corrispondenti. Il client può inviare in una richiesta meno o più versioni rispetto ai nomi. Tuttavia, il client NON DEVE inviare più versioni corrispondenti allo stesso nome; in caso affermativo, verrà visualizzato un errore.

Nota cronologica: nella versione 4 dell'API era denominato states; per maggiore chiarezza, ora è stato rinominato in version.

Una stringa con codifica Base64.

desiredHashLength

enum (HashLength)

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

Diversi elenchi di hash 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, i client riceveranno un errore.

Per BatchGetHashListsRequest in particolare, i clienti non possono specificare desiredHashLength differenti per elenchi differenti. Se è necessario farlo, il client deve suddividersi in più BatchGetHashListsRequest.

sizeConstraints

object (SizeConstraints)

I vincoli di dimensione in ogni elenco. Se omesso, non ci sono vincoli. Tieni presente che le dimensioni qui indicate sono per elenco, non aggregate per 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 elenchi di hashing nello stesso ordine specificato nella richiesta.