Safe Browsing API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لتطبيقات العميل التحقّق من موارد الويب (عناوين URL في أغلب الأحيان) من خلال مقارنتها بقائمة أنشأتها Google تضمّ مصادر الويب غير الآمنة. واجهات برمجة التطبيقات لميزة "التصفّح الآمن" مخصّصة للاستخدام غير التجاري فقط. إذا كنت بحاجة إلى استخدام واجهات برمجة التطبيقات لرصد عناوين URL الضارة لأغراض تجارية، أي "لأغراض البيع أو تحقيق الأرباح"، يُرجى الرجوع إلى Web Risk API.
الخدمة: safebrowsing.googleapis.com
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تحتوي خدمة واحدة على نقاط نهاية خدمة متعددة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
