Method: fullHashes.find
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחפשת את הגיבובים המלאים שתואמים לקידומות הגיבוב המבוקשות.
בקשת HTTP
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
{
"client": {
object (ClientInfo )
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo )
},
"apiClient": {
object (ClientInfo )
}
} |
שדות |
client |
object (ClientInfo )
המטא-נתונים של הלקוח
|
clientStates[] |
string (bytes format)
הלקוח הנוכחי מציין לגבי כל אחת מרשימות האיומים המקומיות של הלקוח. מחרוזת בקידוד base64.
|
threatInfo |
object (ThreatInfo )
הרשימות וגיבובים לבדיקה.
|
apiClient |
object (ClientInfo )
מטא-נתונים של לקוחות שמשויכים לקריאות של ממשקי API ברמה גבוהה יותר, שמבוססים על ההטמעה של הלקוח.
|
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"matches": [
{
object (ThreatMatch )
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
שדות |
matches[] |
object (ThreatMatch )
הגיבובים המלאים שתואמים לקידומות המבוקשות.
|
minimumWaitDuration |
string (Duration format)
משך הזמן המינימלי שהלקוח צריך להמתין לפני שליחה של בקשת גיבובים לחיפוש. אם השדה הזה לא מוגדר, הלקוחות יכולים לשלוח בקשה בהקדם האפשרי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s '. לדוגמה: "3.5s" .
|
negativeCacheDuration |
string (Duration format)
מהו משך הזמן לשמירת התגובה במטמון, אם הישויות המבוקשות לא תואמות לרשימת האיומים. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s '. לדוגמה: "3.5s" .
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-06 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-03-06 (שעון UTC)."],[[["This API finds full hashes that match requested hash prefixes using a POST request to `https://safebrowsing.googleapis.com/v4/fullHashes:find`."],["The request body includes client metadata, client states, threat information, and API client details, structured according to the provided JSON schema."],["The response body provides matching full hashes, minimum wait duration before the next request, and negative cache duration for non-matching entities, all formatted as described in the schema."]]],["This document details the process for finding full hashes matching requested hash prefixes via the `fullHashes:find` API. A `POST` request to the specified URL includes a JSON request body with client metadata (`client`, `apiClient`), client states (`clientStates`), and threat information (`threatInfo`). The response, if successful, contains matched full hashes (`matches`), a minimum wait duration (`minimumWaitDuration`) before the next request, and a negative cache duration (`negativeCacheDuration`).\n"]]