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

enum (HashLength)

返されたハッシュの望ましいハッシュ プレフィックス長(バイト単位)。サーバーは、指定された長さのすべてのハッシュ接頭辞を返します。

ハッシュリストが異なれば、desiredHashLength フィールドに指定できる値の要件も異なります。これは HashListMetadatasupportedHashLengths フィールドにあります。desiredHashLengthsupportedHashLengths 内の値が指定されていない場合は、エラーが返されます。

sizeConstraints

object (SizeConstraints)

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

リクエスト本文

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

レスポンスの本文

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