Method: hashList.get

Get the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache.

This is a standard Get method as defined by https://google.aip.dev/131 and the HTTP method is also GET.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache.

Query parameters

Parameters
version

string (bytes format)

The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST be left empty. Otherwise, the client SHOULD supply the version previously received from the server. The client MUST NOT manipulate those bytes.

What's new in V5: in V4 of the API, this was called states; it is now renamed to version for clarity.

A base64-encoded string.
desiredHashLength

enum (HashLength)

The desired hash prefix length of the returned hashes in bytes. The server will then return all hash prefixes in this specified length.

Different hash lists have different requirements on the acceptable values of desiredHashLength field. This can be found in the supportedHashLengths field in HashListMetadata. If desiredHashLength does not specify a value within supportedHashLengths, an error will be returned.
sizeConstraints

object (SizeConstraints)

The size constraints on the list. If omitted, there are no constraints. Constraints are recommended on all devices with limited processing power, bandwidth, or storage.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of HashList.