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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a list of available hash lists with metadata, excluding their contents.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large sets of hash lists using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGoogle guarantees that hash lists once returned will never be removed, enabling client-side hardcoding.\u003c/p\u003e\n"],["\u003cp\u003eEmploys standard List method with a GET request to \u003ccode\u003ehttps://safebrowsing.googleapis.com/v5alpha1/hashLists\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes details about each hash list and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["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"],null,["# Method: hashLists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListHashListsResponse.SCHEMA_REPRESENTATION)\n\nList hash lists.\n\nIn the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need.\n\nThis is a standard List method as defined by \u003chttps://google.aip.dev/132\u003e and the HTTP method is GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5alpha1/hashLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of hash lists to return. The service may return fewer than this value. If unspecified, the server will choose a page size, which may be larger than the number of hash lists so that pagination is not necessary. |\n| `pageToken` | `string` A page token, received from a previous `hashLists.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response containing metadata about hash lists.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"hashLists\": [ { object (/safe-browsing/reference/rest/v5alpha1/hashList#HashList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5alpha1/hashList#HashList)`)` The hash lists in an arbitrary order. Only metadata about the hash lists will be included, not the contents. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |"]]
