Method: hashLists.batchGet

تعرض هذه الطريقة قوائم تجزئة متعددة في آنٍ واحد.

من الشائع جدًا أن يحتاج العميل إلى الحصول على قوائم تجزئة متعددة. يُفضّل استخدام هذه الطريقة على استخدام طريقة Get العادية عدة مرات.

هذه هي طريقة Get العادية المجمّعة كما هو محدّد في https://google.aip.dev/231، وطريقة HTTP هي أيضًا GET.

طلب HTTP

GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet

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

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

المعلمات
names[]

string

الحقل مطلوب. تمثّل هذه السمة أسماء قوائم التجزئة المحدّدة. قد تكون القائمة قائمة تهديدات أو قد تكون ذاكرة التخزين المؤقت العامة. يجب ألا تحتوي الأسماء على عناصر مكرّرة، وإلا سيظهر للعميل خطأ.
version[]

string (bytes format)

إصدارات قائمة التجزئة التي يملكها العميل. إذا كانت هذه هي المرة الأولى التي يسترد فيها العميل قوائم التجزئة، يجب ترك الحقل فارغًا. بخلاف ذلك، يجب أن يقدّم العميل الإصدارات التي تلقّاها سابقًا من الخادم. يجب ألا يعالج العميل هذه البايتات.

ليس على العميل إرسال الإصدارات بالترتيب نفسه الذي تمّ فيه إدراج أسماء القوائم ذات الصلة. قد يرسل العميل عددًا أقل أو أكبر من الإصدارات في الطلب مقارنةً بعدد الأسماء. ومع ذلك، يجب ألا يرسل العميل إصدارات متعددة تتوافق مع الاسم نفسه، وإذا فعل ذلك، سيتلقّى رسالة خطأ.

ملاحظة حول السجلّ: في الإصدار 4 من واجهة برمجة التطبيقات، كان يُطلق على هذا الحقل الاسم states، وتمت إعادة تسميته الآن إلى version لتوضيحه بشكل أكبر.

سلسلة مرمّزة باستخدام Base64
sizeConstraints

object (SizeConstraints)

قيود الحجم المفروضة على كل قائمة في حال عدم تضمينها، لن تكون هناك أي قيود. يُرجى العِلم أنّ الأحجام هنا هي لكل قائمة، وليس مجمّعة على مستوى جميع القوائم.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الرد الذي يحتوي على قوائم تجزئة متعددة

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

تمثيل JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
الحقول
hashLists[]

object (HashList)

تظهر قوائم التجزئة بالترتيب نفسه الوارد في الطلب.