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)

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

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

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

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

इस जवाब में कई हैश सूचियां शामिल हैं.

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

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

object (HashList)

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