Method: hashLists.batchGet

Visualizza più elenchi di hash contemporaneamente.

È molto comune per un cliente avere bisogno di più liste di hash. È preferibile utilizzare questo metodo rispetto a utilizzare più volte il normale metodo Get.

Si tratta di un metodo Get batch standard come definito da 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 query

Parametri
names[]

string

Obbligatorio. I nomi degli 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 fa, il client riceverà un errore.

version[]

string (bytes format)

Le versioni dell'elenco 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 client non deve inviare le versioni nello stesso ordine dei nomi degli elenchi corrispondenti. Il client potrebbe inviare un numero di versioni inferiore o superiore a quello dei nomi per una richiesta. Tuttavia, il client NON DEVE inviare più versioni che corrispondono allo stesso nome. In caso affermativo, il client riceverà un errore.

Nota storica: nella V4 dell'API, questa funzionalità si chiamava states. è ora rinominata version per maggiore chiarezza.

Una stringa con codifica base64.

desiredHashLength

enum (HashLength)

La lunghezza del prefisso hash desiderata in byte degli hash restituiti. Il server restituirà quindi tutti i prefissi hash con la lunghezza specificata.

Elenchi di hash diversi prevedono requisiti diversi sui valori accettabili del campo desiredHashLength. disponibile nel campo supportedHashLengths in HashListMetadata. Se desiredHashLength non specifica un valore all'interno di supportedHashLengths, verrà restituito un errore ai clienti.

In particolare, per BatchGetHashListsRequest, i clienti non possono specificare un valore desiredHashLength diverso per elenchi diversi. Per eseguire questa operazione, il client deve essere suddiviso 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 riportate sono a livello di 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 hash sono nello stesso ordine indicato nella richiesta.