Method: hashLists.batchGet

الحصول على قوائم تجزئة متعددة في الوقت نفسه

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

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

طلب HTTP

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

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

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

المَعلمات
names[]

string

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

string (bytes format)

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

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

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

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

enum (HashLength)

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

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

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

object (SizeConstraints)

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

نص الطلب

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

نص الاستجابة

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

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

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

object (HashList)

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