Method: hashList.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir karma listedeki en son içerikleri alma Karma listesi, tehdit listesi veya Global Önbelleği gibi tehdit içermeyen bir liste olabilir.
Bu, https://google.aip.dev/131 tarafından tanımlanan standart bir Get yöntemidir ve HTTP yöntemi de GET'tir.
HTTP isteği
GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
name |
string
Zorunlu. Bu karma liste adıdır. Bu, bir tehdit listesi veya Global Önbelleği olabilir.
|
Sorgu parametreleri
Parametreler |
version |
string (bytes format)
İstemcinin sahip olduğu karma listesi sürümü. İstemci karma listesi ilk kez getiriyorsa bu alan BOŞ BIRAKILMASI GEREKİR. Aksi takdirde istemci, daha önce sunucudan alınan sürümü sağlamalıdır. Müşteri bu baytları DEĞİŞTİRMEmelidir. 5. sürümdeki yenilikler: API'nin 4. sürümünde states olarak adlandırılan bu parametre, daha anlaşılır olması için version olarak yeniden adlandırıldı. Base64 kodlu bir dize.
|
sizeConstraints |
object (SizeConstraints )
Listede boyut kısıtlamaları. Atlanırsa herhangi bir kısıtlama yoktur. Sınırlı işlem gücü, bant genişliği veya depolama alanına sahip tüm cihazlarda kısıtlamalar önerilir.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, HashList
öğesinin bir örneğini içerir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\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)."]]