Method: hashList.get

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

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

طلب HTTP

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

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

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

المعلمات
name

string

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

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

المعلمات
version

string (bytes format)

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

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

سلسلة مرمّزة باستخدام Base64

sizeConstraints

object (SizeConstraints)

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

نص الطلب

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

نص الاستجابة

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