Method: hashList.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على أحدث محتوى لقائمة التجزئة يمكن أن تكون قائمة التجزئة قائمة بالتهديدات أو قائمة غير تهديدية، مثل "الذاكرة المؤقتة الشاملة".
هذه طريقة 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
(deprecated) |
enum (HashLength)
طول البادئة المطلوبة للهاشتاغات التي يتم عرضها بالبايت سيعرض الخادم بعد ذلك جميع بادئات التجزئة بهذا الطول المحدّد. تفرض قوائم التجزئة المختلفة متطلبات مختلفة على القيم المقبولة لحقل desiredHashLength. يمكن العثور على هذا الرمز في حقل supportedHashLengths في HashListMetadata. إذا لم تحدّد desiredHashLength قيمة ضمن supportedHashLengths، سيتم عرض خطأ.
|
sizeConstraints |
object (SizeConstraints)
قيود الحجم المفروضة على القائمة في حال حذفها، لن يتم فرض أي قيود. ننصح باستخدام القيود على جميع الأجهزة ذات المعالجة أو معدل نقل البيانات أو سعة التخزين المحدودة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال HashList.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-03-06 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]
