الحصول على قوائم تجزئة متعددة في الوقت نفسه
من الشائع جدًا أن يحتاج العميل إلى قوائم تجزئة متعددة. يُفضل استخدام هذه الطريقة على استخدام طريقة Get العادية عدة مرات.
هذه هي طريقة الحصول على الدفعة المجمّعة كما هو محدّد في https://google.aip.dev/231 وطريقة HTTP هي GET أيضًا.
طلب HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
names[] |
مطلوبة. أسماء قوائم التجزئة المحددة. قد تكون القائمة قائمة تهديدات أو قد تكون ذاكرة التخزين المؤقت العالمية. يجب ألا تحتوي الأسماء على تكرارات؛ في حالة حدوثها، سيتلقى العميل خطأ. |
version[] |
تمثّل هذه السمة إصدارات قائمة التجزئة المتوفّرة لدى العميل. إذا كانت هذه هي المرة الأولى التي يجلب فيها العميل قوائم التجزئة، يجب ترك الحقل فارغًا. وبخلاف ذلك، يجب على العميل تقديم الإصدارات التي تم استلامها سابقًا من الخادم. يجب ألا يعالج العميل وحدات البايت هذه. ولا يحتاج العميل إلى إرسال النُسخ بنفس ترتيب أسماء القوائم المقابلة. قد يرسل العميل نُسخًا أقل أو أكثر في الطلب مقارنةً بالأسماء. ومع ذلك، يجب ألا يرسل العميل إصدارات متعددة تتوافق مع الاسم نفسه، فإذا تم إرسالها، سيتلقّى العميل رسالة خطأ. ملاحظة سابقة: في الإصدار 4 من واجهة برمجة التطبيقات، كان الاسم يُعرف باسم " سلسلة بترميز base64. |
desiredHashLength |
طول بادئة التجزئة المطلوب للتجزئات التي تم عرضها بالبايت. سيعرض الخادم بعد ذلك جميع بادئات التجزئة بهذا الطول المحدد. تتطلب قوائم التجزئة المختلفة متطلبات مختلفة في القيم المقبولة لحقل بالنسبة إلى |
sizeConstraints |
قيود الحجم في كل قائمة. إذا تم حذفها، لن تكون هناك أي قيود. تجدر الإشارة إلى أنّ الأحجام هنا خاصة بكل قائمة، وليست مجمّعة على مستوى كل القوائم. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد الذي يحتوي على قوائم تجزئة متعددة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"hashLists": [
{
object ( |
الحقول | |
---|---|
hashLists[] |
تعرض قوائم التجزئة بالترتيب نفسه الوارد في الطلب. |