Method: threatMatches.find
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تبحث عن إدخالات التهديد التي تتطابق مع قوائم "التصفُّح الآمن".
طلب HTTP
POST https://safebrowsing.googleapis.com/v4/threatMatches:find
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
client |
object (ClientInfo)
البيانات الوصفية للعميل.
|
threatInfo |
object (ThreatInfo)
القوائم والإدخالات التي سيتم التحقّق منها بحثًا عن مطابقات.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
matches[] |
object (ThreatMatch)
تتطابق قائمة التهديدات.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API endpoint allows you to find threat entries that match Safe Browsing lists using an HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires client metadata and information about the threats to be checked, sent as a JSON object.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a JSON object containing a list of any matches found in the Safe Browsing lists.\u003c/p\u003e\n"],["\u003cp\u003eYou can find details about the request and response structures by referencing \u003ccode\u003eClientInfo\u003c/code\u003e, \u003ccode\u003eThreatInfo\u003c/code\u003e, and \u003ccode\u003eThreatMatch\u003c/code\u003e in the provided documentation links.\u003c/p\u003e\n"]]],["The core function is to find threat entries matching Safe Browsing lists. This is achieved via a `POST` request to `https://safebrowsing.googleapis.com/v4/threatMatches:find`. The request body requires a JSON object with `client` and `threatInfo` fields. The successful response body returns a JSON object containing an array `matches[]`, which contains any identified threat matches. The provided links lead to other pages that explain further information.\n"],null,["# Method: threatMatches.find\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FindThreatMatchesResponse.SCHEMA_REPRESENTATION)\n\nFinds the threat entries that match the Safe Browsing lists.\n\n### HTTP request\n\n`POST https://safebrowsing.googleapis.com/v4/threatMatches:find`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"client\": { object (/safe-browsing/reference/rest/v4/ClientInfo) }, \"threatInfo\": { object (/safe-browsing/reference/rest/v4/ThreatInfo) } } ``` |\n\n| Fields ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------|\n| `client` | `object (`[ClientInfo](/safe-browsing/reference/rest/v4/ClientInfo)`)` The client metadata. |\n| `threatInfo` | `object (`[ThreatInfo](/safe-browsing/reference/rest/v4/ThreatInfo)`)` The lists and entries to be checked for matches. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------|\n| ``` { \"matches\": [ { object (/safe-browsing/reference/rest/v4/ThreatMatch) } ] } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------|\n| `matches[]` | `object (`[ThreatMatch](/safe-browsing/reference/rest/v4/ThreatMatch)`)` The threat list matches. |"]]
