Method: hashLists.batchGet
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Aynı anda birden fazla karma listesi alın.
Bir müşterinin birden fazla karma listesi alması çok yaygındır. Normal Get yöntemini birden çok kez kullanmak yerine bu yöntemi kullanmak tercih edilir.
Bu, https://google.aip.dev/231 tarafından tanımlanan standart bir toplu GET yöntemidir ve HTTP yöntemi de GET'tir.
HTTP isteği
GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
names[] |
string
Zorunlu. Belirli karma listelerinin adları. Liste bir tehdit listesi veya genel önbellek OLABİLİR. Adlar yinelenen adlar İÇERMEMELİDİR. Aksi takdirde istemci hata alır.
|
version[] |
string (bytes format)
İstemcinin hâlihazırda sahip olduğu karma listesi sürümleri. İstemci karma listelerini ilk kez getiriyorsa alan boş bırakılmalıdır. Aksi takdirde istemci, daha önce sunucudan alınan sürümleri sağlamalıdır. Müşteri bu baytları DEĞİŞTİRMEmelidir. İstemcinin sürümleri ilgili liste adlarıyla aynı sırayla göndermesi gerekmez. Müşteri, bir istekte adlardan daha az veya daha fazla sürüm gönderebilir. Ancak istemci, aynı ada karşılık gelen birden fazla sürüm GÖNDERMEMELİDİR. Aksi takdirde istemci hata alır. Geçmiş not: API'nin 4. sürümünde bu states olarak adlandırılıyordu. Daha net olması için version olarak yeniden adlandırıldı. Base64 kodlu bir dize.
|
sizeConstraints |
object (SizeConstraints)
Her listenin boyut kısıtlamaları. Atlanırsa herhangi bir kısıtlama yoktur. Buradaki boyutların tüm listeler genelinde toplanmış değil, liste başına olduğunu unutmayın.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Birden fazla karma liste içeren yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"hashLists": [
{
object (HashList)
}
]
} |
| Alanlar |
hashLists[] |
object (HashList)
Karma, istekte verilen sırayla listelenir.
|
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."],[],[],null,["# Method: hashLists.batchGet\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchGetHashListsResponse.SCHEMA_REPRESENTATION)\n\nGet multiple hash lists at once.\n\nIt is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times.\n\nThis is a standard batch Get method as defined by \u003chttps://google.aip.dev/231\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `names[]` | `string` Required. The names of the particular hash lists. The list MAY be a threat list, or it may be the Global Cache. The names MUST NOT contain duplicates; if they did, the client will get an error. |\n| `version[]` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The versions of the hash list that the client already has. If this is the first time the client is fetching the hash lists, the field should be left empty. Otherwise, the client should supply the versions previously received from the server. The client MUST NOT manipulate those bytes. The client need not send the versions in the same order as the corresponding list names. The client may send fewer or more versions in a request than there are names. However the client MUST NOT send multiple versions that correspond to the same name; if it did, the client will get an error. Historical note: 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 each list. If omitted, there are no constraints. Note that the sizes here are per-list, not aggregated across all lists. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response containing multiple hash lists.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------|\n| ``` { \"hashLists\": [ { object (/safe-browsing/reference/rest/v5/hashList#HashList) } ] } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5/hashList#HashList)`)` The hash lists in the same order given in the request. |"]]
