Safe Browsing API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برنامه‌های مشتری را قادر می‌سازد تا منابع وب (معمولاً URLها) را در برابر فهرست‌های ناامن وب ایجاد شده توسط Google بررسی کنند. APIهای مرور ایمن فقط برای استفاده غیرتجاری هستند. اگر نیاز به استفاده از API برای شناسایی URL های مخرب برای اهداف تجاری دارید - به معنی "برای اهداف فروش یا درآمدزایی" - لطفاً به Web Risk API مراجعه کنید.
خدمات: safebrowsing.googleapis.com
نقطه پایان خدمات
نقطه پایانی سرویس یک URL پایه است که آدرس شبکه یک سرویس 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
ورودی های تهدید را پیدا می کند که با لیست های مرور ایمن مطابقت دارند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
