Safe Browsing API
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
讓用戶端應用程式可將網頁資源 (通常是網址) 與 Google 產生的不安全網頁資源清單進行比對。Safe Browsing API 僅供非商業用途使用。如果您需要使用 API 偵測惡意網址,以便用於商業用途 (也就是「用於銷售或創造收益」),請參閱 Web Risk API。
服務:safebrowsing.googleapis.com
服務端點
服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點,且下方的 URI 皆以此服務端點為基準:
https://safebrowsing.googleapis.com
方法 |
get |
GET /v5alpha1/hashList/{name}
取得雜湊清單的最新內容。 |
方法 |
batchGet |
GET /v5alpha1/hashLists:batchGet
一次取得多個雜湊清單。 |
list |
GET /v5alpha1/hashLists
列出雜湊清單。 |
方法 |
search |
GET /v5alpha1/hashes:search
搜尋與指定前置字串相符的完整雜湊。 |
方法 |
get |
GET /v5/hashList/{name}
取得雜湊清單的最新內容。 |
方法 |
batchGet |
GET /v5/hashLists:batchGet
一次取得多個雜湊清單。 |
list |
GET /v5/hashLists
列出雜湊清單。 |
方法 |
search |
GET /v5/hashes:search
搜尋與指定前置字串相符的完整雜湊。 |
方法 |
find |
POST /v4/fullHashes:find
找出與要求的雜湊前置字相符的完整雜湊。 |
方法 |
fetch |
POST /v4/threatListUpdates:fetch
擷取最新的威脅清單更新內容。 |
方法 |
list |
GET /v4/threatLists
列出可供下載的安全瀏覽威脅清單。 |
方法 |
find |
POST /v4/threatMatches:find
找出與安全瀏覽清單相符的威脅項目。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThe Safe Browsing APIs enable client applications to cross-reference web resources, primarily URLs, with Google's lists of unsafe web resources for non-commercial use only.\u003c/p\u003e\n"],["\u003cp\u003eCommercial users seeking malicious URL detection should utilize the Web Risk API instead of the Safe Browsing APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe APIs offer various functionalities, including retrieving hash lists, searching for full hashes based on prefixes, and fetching recent threat list updates.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for accessing these APIs is \u003ccode\u003ehttps://safebrowsing.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eMultiple REST resources, such as \u003ccode\u003ev5alpha1.hashList\u003c/code\u003e, \u003ccode\u003ev5alpha1.hashLists\u003c/code\u003e, and \u003ccode\u003ev5alpha1.hashes\u003c/code\u003e, are available for interacting with the service.\u003c/p\u003e\n"]]],["The Safe Browsing APIs enable non-commercial client applications to verify web resources against Google's unsafe web resource lists; commercial use requires the Web Risk API. Key actions include: fetching threat list updates, searching for matching hash prefixes, retrieving full hashes, and listing available threat lists. Using the REST resource you can get individual hash lists, or get them in batches. The service endpoint is `https://safebrowsing.googleapis.com`.\n"],null,["# Safe Browsing API\n\nEnables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes -- meaning \"for sale or revenue-generating purposes\" -- please refer to the Web Risk API.\n\n- [REST Resource: v5alpha1.hashList](#v5alpha1.hashList)\n- [REST Resource: v5alpha1.hashLists](#v5alpha1.hashLists)\n- [REST Resource: v5alpha1.hashes](#v5alpha1.hashes)\n- [REST Resource: v5.hashList](#v5.hashList)\n- [REST Resource: v5.hashLists](#v5.hashLists)\n- [REST Resource: v5.hashes](#v5.hashes)\n- [REST Resource: v4.fullHashes](#v4.fullHashes)\n- [REST Resource: v4.threatListUpdates](#v4.threatListUpdates)\n- [REST Resource: v4.threatLists](#v4.threatLists)\n- [REST Resource: v4.threatMatches](#v4.threatMatches)\n\nService: safebrowsing.googleapis.com\n------------------------------------\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://safebrowsing.googleapis.com`\n\nREST Resource: [v5alpha1.hashList](/safe-browsing/reference/rest/v5alpha1/hashList)\n-----------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------|-------------------------------------------------------------------------|\n| [get](/safe-browsing/reference/rest/v5alpha1/hashList/get) | `GET /v5alpha1/hashList/{name}` Get the latest contents of a hash list. |\n\nREST Resource: [v5alpha1.hashLists](/safe-browsing/reference/rest/v5alpha1/hashLists)\n-------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------|---------------------------------------------------------------------|\n| [batchGet](/safe-browsing/reference/rest/v5alpha1/hashLists/batchGet) | `GET /v5alpha1/hashLists:batchGet` Get multiple hash lists at once. |\n| [list](/safe-browsing/reference/rest/v5alpha1/hashLists/list) | `GET /v5alpha1/hashLists` List hash lists. |\n\nREST Resource: [v5alpha1.hashes](/safe-browsing/reference/rest/v5alpha1/hashes)\n-------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| [search](/safe-browsing/reference/rest/v5alpha1/hashes/search) | `GET /v5alpha1/hashes:search` Search for full hashes matching the specified prefixes. |\n\nREST Resource: [v5.hashList](/safe-browsing/reference/rest/v5/hashList)\n-----------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------|-------------------------------------------------------------------|\n| [get](/safe-browsing/reference/rest/v5/hashList/get) | `GET /v5/hashList/{name}` Get the latest contents of a hash list. |\n\nREST Resource: [v5.hashLists](/safe-browsing/reference/rest/v5/hashLists)\n-------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------|---------------------------------------------------------------|\n| [batchGet](/safe-browsing/reference/rest/v5/hashLists/batchGet) | `GET /v5/hashLists:batchGet` Get multiple hash lists at once. |\n| [list](/safe-browsing/reference/rest/v5/hashLists/list) | `GET /v5/hashLists` List hash lists. |\n\nREST Resource: [v5.hashes](/safe-browsing/reference/rest/v5/hashes)\n-------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------|---------------------------------------------------------------------------------|\n| [search](/safe-browsing/reference/rest/v5/hashes/search) | `GET /v5/hashes:search` Search for full hashes matching the specified prefixes. |\n\nREST Resource: [v4.fullHashes](/safe-browsing/reference/rest/v4/fullHashes)\n---------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------|------------------------------------------------------------------------------------------|\n| [find](/safe-browsing/reference/rest/v4/fullHashes/find) | `POST /v4/fullHashes:find` Finds the full hashes that match the requested hash prefixes. |\n\nREST Resource: [v4.threatListUpdates](/safe-browsing/reference/rest/v4/threatListUpdates)\n-----------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------|---------------------------------------------------------------------------------|\n| [fetch](/safe-browsing/reference/rest/v4/threatListUpdates/fetch) | `POST /v4/threatListUpdates:fetch` Fetches the most recent threat list updates. |\n\nREST Resource: [v4.threatLists](/safe-browsing/reference/rest/v4/threatLists)\n-----------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------|------------------------------------------------------------------------------------|\n| [list](/safe-browsing/reference/rest/v4/threatLists/list) | `GET /v4/threatLists` Lists the Safe Browsing threat lists available for download. |\n\nREST Resource: [v4.threatMatches](/safe-browsing/reference/rest/v4/threatMatches)\n---------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| [find](/safe-browsing/reference/rest/v4/threatMatches/find) | `POST /v4/threatMatches:find` Finds the threat entries that match the Safe Browsing lists. |"]]