Method: hashList.get

हैश सूची की नई सामग्री पाएं. हैश सूची या तो किसी खतरे की सूची के तौर पर हो सकती है या ग्लोबल कैश जैसी बिना खतरे वाली सूची के रूप में.

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

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

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

पाथ के पैरामीटर

पैरामीटर
name

string

ज़रूरी है. इस हैश सूची का नाम. यह खतरा सूची हो सकती है या ग्लोबल कैश मेमोरी हो सकती है.

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

पैरामीटर
version

string (bytes format)

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

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

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

enum (HashLength)

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

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

object (SizeConstraints)

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

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

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

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में HashList का एक इंस्टेंस शामिल किया जाता है.