Method: urls.search

搜尋與已知威脅相符的網址。系統會檢查每個網址，以及主機後置字串和路徑前置字串運算式 (深度有限)。也就是說，回應可能包含要求中未列出的網址，但這些網址是所要求網址的運算式。

HTTP 要求

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

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

查詢參數

參數
urls[]

string

必填。要查詢的網址。用戶端不得傳送超過 50 個網址。

要求主體

要求主體必須為空白。

回應主體

搜尋與指定網址相符的威脅後，系統傳回的回應。

如果找不到任何內容，伺服器會傳回 OK 狀態 (HTTP 狀態碼 200)，且 threats 欄位為空白，而不是傳回 NOT_FOUND 狀態 (HTTP 狀態碼 404)。

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

JSON 表示法 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
欄位
threats[]

object (ThreatUrl)

未排序的清單。找到的威脅比對結果 (無序清單)。每個項目都包含一個網址，以及與該網址相符的威脅類型。清單大小可能大於要求中的網址數量，因為系統會考量網址的所有運算式。
cacheDuration

string (Duration format)

用戶端快取時間長度。用戶端「必須」將這段時間加到目前時間，以判斷到期時間。之後，無論回應中傳回多少網址，用戶端在要求中查詢的每個網址都會套用這個到期時間。即使伺服器未傳回特定網址的相符項目，用戶端也「必須」快取這項事實。

只有在 threats 欄位空白時，用戶端才可增加 cacheDuration，以判斷晚於伺服器指定時間的新到期時間。無論如何，增加的快取時間不得超過 24 小時。

重要事項：用戶端「不得」假設伺服器會為所有回應傳回相同的快取時間長度。伺服器可視情況為不同回應選擇不同的快取時間長度。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

ThreatUrl

網址符合一或多項威脅。

JSON 表示法 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
欄位
url

string

與一或多項威脅相符的要求網址。
threatTypes[]

enum (ThreatType)

未排序的清單。網址分類為無序清單的威脅。