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
sizeConstraints

object (SizeConstraints)

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

نص الطلب

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

نص الاستجابة

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

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

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

object (HashList)

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