Method: hashLists.list

列出雜湊清單。

在 V5 API 中,Google 絕不會移除此方法所傳回的雜湊清單。這可讓用戶端略過此方法,直接對需要的所有雜湊清單進行硬式編碼。

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

HTTP 要求

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

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

查詢參數

參數
pageSize

integer

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

pageToken

string

屬於接收自前一個 hashLists.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

要求主體

要求主體必須為空白。

回應主體

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

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

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

object (HashList)

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

nextPageToken

string

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