Method: hashLists.batchGet

一次取得多個雜湊清單。

客戶通常需要取得多個雜湊清單。相較於多次使用一般 Get 方法,建議使用這個方法。

這是 https://google.aip.dev/231 定義的標準批次 Get 方法,HTTP 方法也是 GET。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
names[]

string

必填。特定雜湊清單的名稱。清單「可能」是威脅清單,也可能是全域快取。名稱不得重複,否則用戶端會收到錯誤訊息。

version[]

string (bytes format)

用戶端已有的雜湊清單版本。如果這是用戶端第一次擷取雜湊清單,請將這個欄位留空。否則,用戶端應提供先前從伺服器收到的版本。用戶端「不得」操縱這些位元組。

用戶端不必按照對應清單名稱的順序傳送版本。用戶端在要求中傳送的版本數量可能少於或多於名稱數量。不過,用戶端不得傳送對應相同名稱的多個版本,否則會收到錯誤訊息。

歷史記錄:在 API V4 中,這項功能稱為 states;為求清楚,現在已重新命名為 version

Base64 編碼字串。

sizeConstraints

object (SizeConstraints)

各清單的大小限制。如果省略,則沒有限制。請注意,這裡顯示的是每個清單的大小,而非所有清單的總和。

要求主體

要求主體必須為空白。

回應主體

包含多個雜湊清單的回應。

如果成功,回應主體會含有以下結構的資料:

JSON 表示法
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
欄位
hashLists[]

object (HashList)

雜湊清單的順序與要求中提供的順序相同。