Method: hashList.get

الحصول على أحدث محتوى قائمة التجزئة قد تكون قائمة التجزئة إما عن طريق قائمة تهديدات أو قائمة غير تهديدات مثل ذاكرة التخزين المؤقت العالمية.

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

طلب HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

معلمات المسار

المَعلمات
name

string

مطلوبة. تمثّل هذه السمة اسم قائمة التجزئة المحدّدة هذه. قد تكون قائمة تهديدات أو ذاكرة التخزين المؤقت العالمية.

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

المَعلمات
version

string (bytes format)

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

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

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

enum (HashLength)

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

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

object (SizeConstraints)

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

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال HashList.