Method: hashLists.list

列出雜湊清單。

在 V5 API 中,Google 絕對不會移除這個方法曾經傳回的雜湊清單。這樣客戶就能略過使用這個方法,直接對所有需要的雜湊清單進行硬式編碼。

這是標準的 List 方法,由 https://google.aip.dev/132 定義,而 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 傳送的權杖,用於擷取後續網頁。如果省略這個欄位,就不會有後續頁面。