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".