Method: hashLists.list
سرد قوائم التجزئة
في V5 API، لن تزيل Google قائمة تجزئة تم عرضها من قبل باستخدام هذه الطريقة. ويتيح ذلك للعملاء تخطّي هذه الطريقة وإجراء ترميز ثابت لجميع قوائم علامات التجزئة التي يحتاجون إليها.
وهذه طريقة "قائمة" عادية كما هو موضّح في https://google.aip.dev/132، وطريقة HTTP هي GET.
طلب HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد قوائم التجزئة المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. في حال عدم تحديد ذلك، سيختار الخادم حجم الصفحة الذي قد يكون أكبر من عدد قوائم علامات التجزئة كي لا يكون التقسيم على صفحات ضروريًا.
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "hashLists.list ". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
يشير هذا المصطلح إلى الردّ الذي يحتوي على بيانات وصفية حول قوائم علامات التجزئة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"hashLists": [
{
object (HashList )
}
],
"nextPageToken": string
} |
الحقول |
hashLists[] |
object (HashList )
تعرض علامة التجزئة ترتيبًا عشوائيًا. سيتم تضمين بيانات وصفية حول قوائم علامات التجزئة فقط وليس المحتوى.
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-10-11 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-10-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves a list of available hash lists with metadata, excluding their contents."],["Allows for pagination to retrieve large sets of hash lists using `pageSize` and `pageToken`."],["Google guarantees that hash lists once returned will never be removed, enabling client-side hardcoding."],["Employs standard List method with a GET request to `https://safebrowsing.googleapis.com/v5alpha1/hashLists`."],["Response includes details about each hash list and a token for retrieving subsequent pages if available."]]],["This document details the process for retrieving metadata about hash lists using the V5 API's `hashLists.list` method. It uses an HTTP GET request to `https://safebrowsing.googleapis.com/v5alpha1/hashLists`. Optional query parameters include `pageSize` to limit results and `pageToken` for pagination. The request body must be empty. The response body includes an array of `hashLists` and an optional `nextPageToken` for subsequent pages. The API never removes returned hash lists.\n"]]