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)

البيانات الوصفية للعملاء المرتبطة باستدعاء واجهات برمجة التطبيقات ذات المستوى الأعلى، والتي تم إنشاؤها في أعقاب تنفيذ البرنامج.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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".