Method: hashList.get
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
آخرین مطالب یک لیست هش را دریافت کنید. یک لیست هش ممکن است با یک لیست تهدید یا یک لیست غیرتهدید مانند کش جهانی باشد.
این یک متد Get استاندارد است که توسط https://google.aip.dev/131 تعریف شده است و روش HTTP نیز GET است.
درخواست HTTP
GET https://safebrowsing.googleapis.com/v5/hashList/{name}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
name | string مورد نیاز. نام این لیست هش خاص. ممکن است یک لیست تهدید باشد یا ممکن است کش جهانی باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
version | string ( bytes format) نسخه هش لیستی که مشتری از قبل دارد. اگر این اولین بار است که مشتری لیست هش را واکشی می کند، این قسمت باید خالی بماند. در غیر این صورت، کلاینت باید نسخه ای را که قبلاً از سرور دریافت کرده است، ارائه دهد. کلاینت نباید آن بایت ها را دستکاری کند. چه چیزی در V5 جدید است : در V4 از API، این states نامیده می شد. اکنون برای وضوح به version تغییر نام داده شده است. رشته ای با کد base64. |
sizeConstraints | object ( SizeConstraints ) محدودیت اندازه در لیست در صورت حذف، هیچ محدودیتی وجود ندارد. محدودیت ها برای همه دستگاه هایی با قدرت پردازش، پهنای باند یا ذخیره سازی محدود توصیه می شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه از HashList است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: hashList.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nGet the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache.\n\nThis is a standard Get method as defined by \u003chttps://google.aip.dev/131\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashList/{name}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST be left empty. Otherwise, the client SHOULD supply the version previously received from the server. The client MUST NOT manipulate those bytes. **What's new in V5** : in V4 of the API, this was called `states`; it is now renamed to `version` for clarity. A base64-encoded string. |\n| `sizeConstraints` | `object (`[SizeConstraints](/safe-browsing/reference/rest/v5/SizeConstraints)`)` The size constraints on the list. If omitted, there are no constraints. Constraints are recommended on all devices with limited processing power, bandwidth, or storage. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [HashList](/safe-browsing/reference/rest/v5/hashList#HashList)."]]
