Method: urls.search

חיפוש כתובות URL שתואמות לאיומים מוכרים. המערכת בודקת כל כתובת URL ואת הביטויים של סיומת המארח וקידומת הנתיב שלה (עד עומק מוגבל). כלומר, התשובה עשויה להכיל כתובות URL שלא נכללו בבקשה, אבל הן ביטויים של כתובות ה-URL המבוקשות.

בקשת HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
urls[]

string

חובה. כתובות ה-URL שרוצים לחפש. הלקוחות לא יכולים לשלוח יותר מ-50 כתובות URL.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

התשובה שמוחזרת אחרי חיפוש איומים שתואמים לכתובות ה-URL שצוינו.

אם לא נמצא דבר, השרת יחזיר סטטוס OK (קוד סטטוס HTTP 200) עם שדה threats ריק, במקום להחזיר סטטוס NOT_FOUND (קוד סטטוס HTTP 404).

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
שדות
threats[]

object (ThreatUrl)

רשימה לא ממוינת. רשימה לא מסודרת של התאמות לאיומים שנמצאו. כל רשומה מכילה כתובת URL ואת סוגי האיומים שנמצאו בהתאמה לכתובת ה-URL הזו. גודל הרשימה יכול להיות גדול ממספר כתובות ה-URL בבקשה, כי כל הביטויים של כתובת ה-URL נלקחים בחשבון.
cacheDuration

string (Duration format)

משך הזמן של המטמון בצד הלקוח. הלקוח חייב להוסיף את משך הזמן הזה לשעה הנוכחית כדי לקבוע את שעת התפוגה. לאחר מכן, זמן התפוגה חל על כל כתובת URL שהלקוח שולח לגביה שאילתה בבקשה, ללא קשר למספר כתובות ה-URL שמוחזרות בתגובה. גם אם השרת לא מחזיר התאמות לכתובת URL מסוימת, הלקוח חייב לשמור את העובדה הזו במטמון.

אם השדה threats ריק, הלקוח יכול להגדיל את הערך של cacheDuration כדי לקבוע תאריך תפוגה חדש שמאוחר יותר מזה שצוין על ידי השרת. בכל מקרה, משך הזמן המוגדל של השמירה במטמון לא יכול להיות ארוך מ-24 שעות.

חשוב: הלקוח לא יכול להניח שהשרת יחזיר את אותו משך זמן של שמירה במטמון לכל התגובות. יכול להיות שהשרת יבחר משכי זמן שונים של שמירה במטמון לתגובות שונות, בהתאם למצב.

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

ThreatUrl

כתובת URL שתואמת לאיום אחד או יותר.

ייצוג ב-JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
שדות
url

string

כתובת ה-URL המבוקשת שתאמה לאיום אחד או יותר.
threatTypes[]

enum (ThreatType)

רשימה לא ממוינת. רשימה לא מסודרת של האיומים שכתובת ה-URL מסווגת כקשורים אליהם.