Method: hashList.get

取得雜湊清單的最新內容。雜湊清單可以是威脅清單,也可以是全球快取等非威脅清單。

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

HTTP 要求

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

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

路徑參數

參數
name

string

必要欄位。這個特定雜湊清單的名稱。可能是威脅清單,也可能是全球快取。

查詢參數

參數
version

string (bytes format)

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

第 5 版的新功能:在 API 的 4 版中,這個屬性稱為 states;現在已重新命名為 version,以利區分。

Base64 編碼字串。

desiredHashLength
(deprecated)

enum (HashLength)

所需雜湊前置字串長度 (以位元組為單位)。然後,伺服器會傳回所有指定長度的雜湊字首。

不同的雜湊清單對 desiredHashLength 欄位可接受的值有不同的規定。您可以在 HashListMetadatasupportedHashLengths 欄位中找到這項資訊。如果 desiredHashLength 未在 supportedHashLengths 中指定值,系統會傳回錯誤。

sizeConstraints

object (SizeConstraints)

清單的大小限制。如果省略,則沒有任何限制。建議在所有處理能力、頻寬或儲存空間受限的裝置上使用限制。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 HashList 的執行例項。