Method: urls.search

البحث عن عناوين URL تتطابق مع التهديدات المعروفة يتم التحقّق من كل عنوان URL وعبارات لاحقة المضيف وبادئة المسار (حتى عمق محدود). يعني ذلك أنّ الاستجابة قد تحتوي على عناوين URL لم يتم تضمينها في الطلب، ولكنّها تعبّر عن عناوين URL المطلوبة.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
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 على أنّه يندرج ضمنها.