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