Method: hashList.get

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

यह https://google.aip.dev/131 में बताए गए स्टैंडर्ड Get तरीके का इस्तेमाल करता है. साथ ही, एचटीटीपी तरीका भी GET है.

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

पैरामीटर
version

string (bytes format)

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

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

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

object (SizeConstraints)

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

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

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

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

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