Method: hashList.get

ハッシュリストの最新のコンテンツを取得します。ハッシュリストは、脅威リストまたはグローバル キャッシュなどの脅威以外のリストのいずれかです。

これは https://google.aip.dev/131 で定義されている標準の Get メソッドであり、HTTP メソッドも GET です。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。この特定のハッシュリストの名前。脅威リストまたはグローバル キャッシュのいずれかです。

クエリ パラメータ

パラメータ
version

string (bytes format)

クライアントがすでに持っているハッシュリストのバージョン。クライアントがハッシュリストを初めて取得する場合は、このフィールドを空にする必要があります。それ以外の場合は、クライアントはサーバーが以前に送信したバージョンを提供する必要があります。クライアントはこれらのバイトを操作してはなりません。

v5 の新機能: API の v4 では states と呼ばれていましたが、わかりやすくするために version に名前が変更されました。

Base64 でエンコードされた文字列。
desiredHashLength
(deprecated)

enum (HashLength)

返されるハッシュのハッシュ プレフィックスの長さ（バイト単位）。サーバーは、この指定された長さのすべてのハッシュ プレフィックスを返します。

ハッシュリストによって、desiredHashLength フィールドで許容される値の要件が異なります。これは HashListMetadata の supportedHashLengths フィールドで確認できます。desiredHashLength で supportedHashLengths 内の値が指定されていない場合、エラーが返されます。
sizeConstraints

object (SizeConstraints)

リストのサイズ制限。省略した場合、制約はありません。制約は、処理能力、帯域幅、ストレージが制限されているすべてのデバイスに推奨されます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には HashList のインスタンスが含まれます。