Method: hashList.get

Ottieni i contenuti più recenti di un elenco di hashing. Un elenco di hash può essere costituito da un elenco di minacce o da un elenco non-minaccia come la cache globale.

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

Richiesta HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

obbligatorio. Il nome di questo particolare elenco di hash. Potrebbe trattarsi di un elenco di minacce o della cache globale.

Parametri di ricerca

Parametri
version

string (bytes format)

La versione dell'elenco di hash già in possesso del client. Se è la prima volta che il client recupera l'elenco di hash, questo campo DEVE essere lasciato vuoto. In caso contrario, il client DOVREBBE fornire la versione precedentemente ricevuta dal server. Il client NON DEVE manipolare questi byte.

Novità della V5: nella V4 dell'API, questo si chiamava 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, verrà restituito un errore.
sizeConstraints

object (SizeConstraints)

I vincoli di dimensione nell'elenco. Se omesso, non ci sono vincoli. I vincoli sono consigliati su tutti i dispositivi con potenza di elaborazione, larghezza di banda o spazio di archiviazione limitati.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di HashList.