Method: hashLists.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימות גיבוב.
ב-API V5, Google לעולם לא תסיר רשימת גיבוב שהוחזרה אי פעם באמצעות השיטה הזו. כך הלקוחות יכולים לדלג על השימוש בשיטה הזו ולכתוב בקוד את כל רשימות הגיבוב שהם צריכים.
זוהי שיטת List רגילה כפי שמוגדרת ב-https://google.aip.dev/132, ושיטת ה-HTTP היא GET.
בקשת HTTP
GET https://safebrowsing.googleapis.com/v5/hashLists
כתובת ה-URL משתמשת בתחביר של Transcoding של 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],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/v5/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/v5/hashList#HashList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5/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. |"]]