Method: hashLists.batchGet

string

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

string (bytes format)

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

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

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

سلسلة مُشفَّرة باستخدام base64

enum (HashLength)

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

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

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

object (SizeConstraints)

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