Method: hashLists.batchGet

Tek seferde birden fazla karma listesi oluşturun.

Bir müşterinin birden fazla karma listesi alması yaygındır. Normal Get yönteminin birden çok kez kullanılması yerine bu yöntemin kullanılması tercih edilir.

Bu, https://google.aip.dev/231 ile tanımlanan standart bir toplu Get yöntemidir ve HTTP yöntemi de GET'dir.

HTTP isteği

GET https://safebrowsing.googleapis.com/v5alpha1/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 olabilir veya Genel Önbellek olabilir. Adlar yinelenen öğeler İÇERMEMELİDİR; açıkladıysa müşteri bir hata alır.
version[]

string (bytes format)

Müşterinin zaten sahip olduğu karma listesi sürümleri. İstemci karma listelerini ilk kez getiriyorsa alan boş bırakılmalıdır. Aksi takdirde, istemcinin sunucudan daha önce aldığı sürümleri sağlaması gerekir. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

İstemcinin, sürümleri ilgili liste adlarıyla aynı sırada göndermesi gerekmez. İstemci bir istekte adlara göre daha az veya daha fazla sürüm gönderebilir. Ancak, istemci aynı ada karşılık gelen birden fazla versiyon GÖNDERMEMELİDİR; istekte bulunulmuşsa istemci bir hata alacaktır.

Geçmişteki not: API'nin 4. sürümünde buna states adı veriliyordu; daha net bir şekilde version olarak yeniden adlandırıldı.

base64 kodlu bir dize.
desiredHashLength

enum (HashLength)

Döndürülen karmaların bayt cinsinden istenen karma öneki uzunluğu. Daha sonra sunucu, belirtilen uzunluktaki tüm karma ön eklerini döndürür.

Farklı karma listeleri, desiredHashLength alanının kabul edilebilir değerleri konusunda farklı koşullara sahiptir. Bu, HashListMetadata tablosundaki supportedHashLengths alanında bulunabilir. desiredHashLength, supportedHashLengths içinde bir değer belirtmezse istemcilere bir hata döndürülür.

Özellikle BatchGetHashListsRequest için, müşterilerin farklı listeler için farklı bir desiredHashLength belirtmesi mümkün değildir. Bunun yapılması gerekiyorsa müşteri birden fazla BatchGetHashListsRequest öğesine bölünmelidir.
sizeConstraints

object (SizeConstraints)

Her listedeki boyut kısıtlamaları. Atlanırsa hiçbir kısıtlama uygulanmaz. Buradaki boyutların tüm listeler genelinde toplanmadığı, liste bazında olduğunu unutmayın.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Birden fazla karma listesi 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 oluşturma işlemi, istekte belirtilen sırada listelenir.