الحصول على أحدث محتوى لقائمة التجزئة يمكن أن تكون قائمة التجزئة قائمة بالتهديدات أو قائمة غير تهديدية، مثل "الذاكرة المؤقتة الشاملة".
هذه طريقة Get عادية كما هو محدّد في https://google.aip.dev/131، وطريقة HTTP هي GET أيضًا.
طلب HTTP
GET https://safebrowsing.googleapis.com/v5/hashList/{name}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
name |
مطلوب. اسم قائمة التجزئة هذه قد تكون قائمة بالتهديدات، أو قد تكون ذاكرة التخزين المؤقت الشاملة. |
مَعلمات طلب البحث
المعلمات | |
---|---|
version |
إصدار قائمة التجزئة التي يمتلكها العميل إذا كانت هذه هي المرة الأولى التي يحصل فيها العميل على قائمة التجزئة، يجب ترك هذا الحقل فارغًا. بخلاف ذلك، يجب أن يقدّم العميل الإصدار الذي تم استلامه سابقًا من الخادم. يجب ألّا يغيّر العميل هذه البايتات. الجديد في الإصدار 5: في الإصدار 4 من واجهة برمجة التطبيقات، كان هذا الحقل يُعرف باسم سلسلة بترميز base64 |
sizeConstraints |
قيود الحجم المفروضة على القائمة في حال حذفها، لن يتم فرض أي قيود. يُنصح باستخدام القيود على جميع الأجهزة ذات المعالجة أو معدل نقل البيانات أو سعة التخزين المحدودة. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال HashList
.