Method: hashList.get
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
آخرین محتویات یک لیست هش را دریافت کنید. یک لیست هش ممکن است با یک لیست تهدید یا یک لیست غیرتهدید مانند کش جهانی باشد.
این یک متد Get استاندارد است که توسط https://google.aip.dev/131 تعریف شده است و روش HTTP نیز GET است.
درخواست HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/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 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGet the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter specifies the hash list to retrieve.\u003c/p\u003e\n"],["\u003cp\u003eProvide the \u003ccode\u003eversion\u003c/code\u003e query parameter to indicate the client's current hash list version or leave it empty for the initial fetch.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, specify the desired hash prefix length using the \u003ccode\u003edesiredHashLength\u003c/code\u003e query parameter and set size constraints with the \u003ccode\u003esizeConstraints\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will contain the requested \u003ccode\u003eHashList\u003c/code\u003e data.\u003c/p\u003e\n"]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"],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/v5alpha1/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/v5alpha1/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/v5alpha1/hashList#HashList)."]]
