Method: hashLists.batchGet

string

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

string (bytes format)

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

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

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

سلسلة بترميز base64.

enum (HashLength)

يشير ذلك المصطلح إلى طول بادئة التجزئة المطلوبة للتجزئات المعروضة بالبايت. سيعرض الخادم جميع بادئات التجزئة بهذا الطول المحدد.

يجب أن تستوفي قوائم التجزئة المختلفة متطلبات مختلفة بشأن القيم المقبولة للحقل desiredHashLength. ويمكن العثور على ذلك في الحقل supportedHashLengths في HashListMetadata. إذا لم يحدّد desiredHashLength قيمة داخل supportedHashLengths، سيتم عرض خطأ للعملاء.

بالنسبة إلى BatchGetHashListsRequest على وجه الخصوص، لا يمكن للعملاء تحديد desiredHashLength مختلف لقوائم مختلفة. وفي هذه الحالة، يجب تقسيم العميل إلى عدة BatchGetHashListsRequest.

object (SizeConstraints)

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