Method: hashLists.batchGet

एक साथ कई हैश सूचियां पाएं.

आम तौर पर, किसी क्लाइंट के लिए एक से ज़्यादा हैश सूचियां पाना ज़रूरी होता है. सामान्य पाएं तरीके का कई बार इस्तेमाल करने के बजाय, इस तरीके का इस्तेमाल करने को प्राथमिकता दी जाती है.

यह एक स्टैंडर्ड बैच पाने का तरीका है, जैसा कि https://google.aip.dev/231 ने तय किया है और एचटीटीपी तरीका भी GET है.

एचटीटीपी अनुरोध

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
names[]

string

ज़रूरी है. खास हैश सूचियों के नाम. यह सूची एक खतरे की सूची हो सकती है या वह ग्लोबल कैश भी हो सकती है. नामों में डुप्लीकेट नहीं होने चाहिए. अगर ऐसा है, तो क्लाइंट को गड़बड़ी मिलेगी.

version[]

string (bytes format)

हैश सूची के वर्शन, जो क्लाइंट के पास पहले से मौजूद हैं. अगर क्लाइंट पहली बार हैश सूचियां फ़ेच कर रहा है, तो फ़ील्ड को खाली छोड़ देना चाहिए. अगर ऐसा नहीं है, तो क्लाइंट को उन वर्शन की सप्लाई करनी चाहिए जो पहले सर्वर से मिले थे. क्लाइंट को उन बाइट में हेर-फेर नहीं करना चाहिए.

क्लाइंट को वर्शन को उसी क्रम में भेजने की ज़रूरत नहीं है जैसा कि उनसे जुड़ी सूची के नामों में होता है. क्लाइंट, अनुरोध में नामों की तुलना में कम या ज़्यादा वर्शन भेज सकता है. हालांकि, क्लाइंट को एक ही नाम से जुड़े कई वर्शन नहीं भेजने चाहिए. अगर ऐसा हुआ, तो क्लाइंट को गड़बड़ी मिलेगी.

पुराना नोट: एपीआई के वर्शन 4 में, इसे states कहा जाता था. साफ़ तौर पर जानकारी देने के लिए, अब इसका नाम बदलकर version कर दिया गया है.

base64 कोड में बदली गई स्ट्रिंग.

desiredHashLength

enum (HashLength)

लौटाए गए हैश की मनचाहा हैश प्रीफ़िक्स बाइट में. इसके बाद, सर्वर इस तय की गई लंबाई में सभी हैश प्रीफ़िक्स दिखाएगा.

desiredHashLength फ़ील्ड में स्वीकार की जाने वाली वैल्यू के लिए, अलग-अलग हैश सूचियों की ज़रूरी शर्तें अलग-अलग होती हैं. इसे HashListMetadata के supportedHashLengths फ़ील्ड में देखा जा सकता है. अगर desiredHashLength, supportedHashLengths में कोई वैल्यू तय नहीं करता है, तो क्लाइंट को गड़बड़ी दिखेगी.

खास तौर पर, BatchGetHashListsRequest के लिए, क्लाइंट के लिए अलग-अलग सूचियों के लिए अलग desiredHashLength तय करना संभव नहीं है. अगर ऐसा करना ज़रूरी है, तो क्लाइंट को एक से ज़्यादा BatchGetHashListsRequest में बांटना चाहिए.

sizeConstraints

object (SizeConstraints)

हर सूची में मौजूद साइज़ की सीमाएं. अगर इसे मिटाया जाता है, तो कोई सीमा नहीं होती. ध्यान दें कि यहां दिए गए साइज़, हर सूची के हिसाब से दिए गए हैं, सभी सूचियों में इकट्ठा नहीं किए गए हैं.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

इस रिस्पॉन्स में, कई हैश सूचियां हैं.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
फ़ील्ड
hashLists[]

object (HashList)

अनुरोध में दिए गए क्रम में हैश की सूचियां.