Method: hashLists.batchGet

一度に複数のハッシュリストを取得します。

クライアントが複数のハッシュリストを取得する必要があることはよくあります。このメソッドは、通常の Get メソッドを複数回使用するよりも推奨されます。

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

HTTP リクエスト

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

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

クエリ パラメータ

パラメータ
names[]

string

必須。特定のハッシュリストの名前。このリストは、脅威リストまたはグローバル キャッシュのいずれかになります。名前に重複を含めてはなりません。重複が含まれている場合、クライアントはエラーを受け取ります。

version[]

string (bytes format)

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

クライアントは、対応するリスト名と同じ順序でバージョンを送信する必要はありません。クライアントは、リクエストで名前の数よりも少ないバージョンまたは多いバージョンを送信できます。ただし、クライアントは同じ名前に対応する複数のバージョンを送信してはなりません。送信した場合、クライアントはエラーを受け取ります。

履歴: API の V4 では、これは states と呼ばれていましたが、明確にするために version に名前が変更されました。

Base64 でエンコードされた文字列。

sizeConstraints

object (SizeConstraints)

各リストのサイズ制約。省略した場合、制約はありません。ここで示されるサイズは、すべてのリストで集計されたものではなく、リストごとのサイズです。

リクエストの本文

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

レスポンスの本文

複数のハッシュリストを含むレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
フィールド
hashLists[]

object (HashList)

ハッシュリストは、リクエストで指定された順序と同じ順序で返されます。