Method: hashLists.batchGet

Aynı anda birden fazla karma listesi alabilirsiniz.

Bir istemcinin birden çok karma listesi alması çok yaygın görülen bir durumdur. Normal Get yöntemini birden çok kez kullanmak yerine bu yöntemin kullanılması tercih edilir.

Bu, https://google.aip.dev/231 tarafından tanımlandığı şekliyle 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 OLABİLİR veya Genel Önbellek olabilir. Adların yinelenen öğeler İÇERMEMESİ ZORUNLUDUR; yinelenen adlar içeriyorsa istemci hata alır.
version[]

string (bytes format)

İstemcinin zaten sahip olduğu karma liste sürümleri. İstemci karma listelerini ilk kez alıyorsa bu alan boş bırakılmalıdır. Aksi takdirde, istemcinin daha önce sunucudan 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öndermesine gerek yoktur. İstemci, bir istekte, mevcut sürümden daha az veya daha fazla sürüm gönderebilir. Ancak, istemci aynı ada karşılık gelen birden çok sürüm GÖNDERMEMELİDİR. Gönderdiyse, istemci bir hata alır.

Geçmişe ilişkin not: API'nin V4'te adı states, daha net olması için şimdi version olarak yeniden adlandırıldı.

Base64 kodlu bir dize.
desiredHashLength

enum (HashLength)

Döndürülen karmaların bayt cinsinden istenen karma ön eki uzunluğu. Ardından sunucu, belirtilen bu uzunluktaki tüm karma önekleri döndürür.

Farklı karma listelerin, desiredHashLength alanının kabul edilebilir değerleriyle ilgili farklı gereksinimleri vardır. Bu değeri HashListMetadata ürünündeki supportedHashLengths alanında bulabilirsiniz. desiredHashLength, supportedHashLengths içinde bir değer belirtmezse istemcilere hata döndürülür.

Özellikle BatchGetHashListsRequest ile ilgili olarak, istemcilerin farklı listeler için farklı bir desiredHashLength belirtmesi mümkün değildir. Böyle bir ihtiyaç varsa istemci birden fazla BatchGetHashListsRequest birimine ayrılmalıdır.
sizeConstraints

object (SizeConstraints)

Her bir listedeki boyut sınırlamaları. Atlanırsa herhangi bir sınırlama olmaz. Buradaki boyutların liste başına olduğunu, tüm listeler genelinde toplanmadığını unutmayın.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Yanıt birden fazla karma liste içeriyor.

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 belirtilen sırada listelenir.