Method: hashLists.list

列出雜湊清單。

在 V5 API 中,Google 絕不會移除這個方法傳回的雜湊清單。這樣一來,用戶端就能略過使用這個方法,只需將所需的所有雜湊清單硬式編碼即可。

這是 https://google.aip.dev/132 定義的標準 List 方法,HTTP 方法為 GET。

HTTP 要求

GET https://safebrowsing.googleapis.com/v5/hashLists

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

查詢參數

參數
pageSize

integer

要傳回的雜湊清單數量上限。服務傳回的產品數量可能會少於這個值。如果未指定,伺服器會選擇頁面大小,這個大小可能會大於雜湊清單數量,因此不需要分頁。

pageToken

string

從先前 hashLists.list 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

要求主體

要求主體必須為空白。

回應主體

回應中包含雜湊清單的中繼資料。

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

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

object (HashList)

雜湊清單以任意順序排列。系統只會納入雜湊清單的中繼資料,而非內容。

nextPageToken

string

可做為 pageToken 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。