Method: hashList.get
Bir karma listedeki en son içerikleri alın. 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ı. 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Ş BIRAKILMALIDIR. Aksi takdirde istemci, daha önce sunucudan alınan sürümü sağlamalıdır. Müşteri bu baytları DEĞİŞTİRMEmelidir. V5'teki 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.
|
desiredHashLength (deprecated) |
enum (HashLength )
Döndürülen karmaların bayt cinsinden istenen karma önek uzunluğu. Sunucu daha sonra bu belirtilen uzunluktaki tüm karma ön eklerinin döndürür. Farklı karma listeleri, desiredHashLength alanının kabul edilebilir değerleriyle ilgili farklı koşullara sahiptir. Bu bilgiyi HashListMetadata 'daki supportedHashLengths alanında bulabilirsiniz. desiredHashLength , supportedHashLengths içinde bir değer belirtmezse hata döndürülür.
|
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-03-06 UTC.
[null,null,["Son güncelleme tarihi: 2025-03-06 UTC."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["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"]]