Method: hashLists.batchGet

الحصول على قوائم علامات هاشتاغ متعددة في آنٍ واحد

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

هذه طريقة 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
(deprecated)

enum (HashLength)

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

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

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

object (SizeConstraints)

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

نص الطلب

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

نص الاستجابة

الاستجابة التي تحتوي على قوائم علامات هاشتاغ متعددة

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

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

object (HashList)

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