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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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. |"]]
