總覽

什麼是 Safe Browsing API？

以下 Safe Browsing API 僅供非商業用途使用。如果您需要根據 API 偵測出惡意使用的商業目的 (例如「販售或產生收益目的」)，請參閱 Web Risk API。

Safe Browsing API (v4) 可讓用戶端應用程式根據 Google 持續更新的不安全網頁資源清單來檢查網址。不安全的網頁資源示例包括社交工程網站 (網路詐騙和詐騙網站)，以及代管惡意軟體或垃圾軟體的網站。 在安全瀏覽清單中找到的任何網址都算是不安全的網址。

如要判斷網址是否列在任何安全瀏覽清單中，用戶端可以使用 Lookup API (v4) 或 Update API (v4)。

搜尋 API (v4)

Query API 可讓用戶端應用程式將網址傳送至 Google 安全瀏覽伺服器來檢查狀態。這個 API 既簡單又容易使用，可避免更新 API 的複雜度。

優點：

  • 簡易網址檢查：您傳送的是內含實際網址的 HTTP POST 要求，且伺服器會以安全或不安全的網址回應。

缺點：

  • 隱私權： 網址未經雜湊處理，因此伺服器會知道您要查詢哪些網址。
  • 回應時間：伺服器會處理每個查詢要求。我們不提供查詢回應時間保證。

如果您不太擔心所查詢網址的隱私權，而且您可以承認網路要求造成的延遲，請考慮使用 Fetch API，因為這項工具相當容易使用。

更新 API (v4)

更新 API 可讓您的用戶端應用程式下載加密版本的「安全瀏覽」清單，以便進行本機用戶端用戶端檢查作業。Update API 是專為需要高頻率、低延遲的用戶端設計而成。有些網路瀏覽器和軟體平台使用這個 API 來保護大量使用者。

優點：

  • 隱私權：您不常使用伺服器交換資料 (僅限在本地雜湊前置字串比對後) 並使用雜湊網址，因此伺服器永遠不會知道用戶端所查詢的實際網址。
  • 回應時間：您維護的本機資料庫含有「安全瀏覽」清單的副本，不需要在每次檢查網址時查詢伺服器。

缺點：

  • 實作：您必須先設定本機資料庫，再下載安全瀏覽清單的本機副本 (以長度長度的 SHA256 雜湊儲存)。
  • 複雜網址檢查：您必須熟悉將網址標準化、建立後置字串/前置字元運算式和計算 SHA256 雜湊的方式 (與安全瀏覽清單的本機副本，以及儲存在伺服器上的安全瀏覽清單的比較)。

如果擔心所查詢網址的隱私權或網路要求產生的延遲時間，請使用 Update API。