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)

משך הזמן המינימלי שהלקוח צריך להמתין לפני שליחת בקשת גיבוב (hash) לחיפוש. אם לא מגדירים את השדה הזה, הלקוחות יכולים לשלוח בקשה בהקדם האפשרי.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".

negativeCacheDuration

string (Duration format)

לישויות המבוקשות שלא תאמו לרשימת האיומים, מהו משך הזמן לשמירת התגובה במטמון.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".