Method: hashLists.batchGet

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/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 veya Global Önbelleği 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.
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 istemcilere hata döndürülür.

Özellikle BatchGetHashListsRequest için istemcilerin farklı listeler için farklı bir desiredHashLength belirtmesi mümkün değildir. Bunun yapılması gerekiyorsa istemci birden fazla BatchGetHashListsRequest'ye bölünmelidir.
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.