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"