Method: hashLists.list
لیست های هش را فهرست کنید.
در V5 API، گوگل هرگز فهرست هش را که تا به حال با این روش برگردانده شده است حذف نمی کند. این به مشتریان امکان می دهد از این روش صرف نظر کنند و به سادگی همه لیست های هش مورد نیاز خود را کد سخت کنند.
این یک روش فهرست استاندارد است که توسط https://google.aip.dev/132 تعریف شده است و روش HTTP GET است.
درخواست HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
pageSize | integer حداکثر تعداد لیست های هش برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر مشخص نباشد، سرور اندازه صفحه را انتخاب می کند که ممکن است بزرگتر از تعداد لیست های هش باشد، بنابراین صفحه بندی ضروری نیست. |
pageToken | string یک نشانه صفحه که از تماس قبلی hashLists.list دریافت شده است. این را برای بازیابی صفحه بعدی ارائه کنید. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ حاوی فراداده در مورد لیست های هش.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"hashLists": [
{
object (HashList )
}
],
"nextPageToken": string
} |
فیلدها |
---|
hashLists[] | object ( HashList ) هش ها به ترتیب دلخواه فهرست می شوند. فقط فراداده مربوط به لیست های هش گنجانده می شود، نه محتویات. |
nextPageToken | string یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی."],[[["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"]]