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 कोड में बदली गई स्ट्रिंग.
|
desiredHashLength
(deprecated) |
enum (HashLength)
हैश के प्रीफ़िक्स की लंबाई, बाइट में. इसके बाद, सर्वर इस तय लंबाई में सभी हैश प्रीफ़िक्स दिखाएगा. अलग-अलग हैश सूचियों के लिए, desiredHashLength फ़ील्ड की स्वीकार की जा सकने वाली वैल्यू से जुड़ी ज़रूरी शर्तें अलग-अलग होती हैं. यह HashListMetadata में supportedHashLengths फ़ील्ड में देखा जा सकता है. अगर desiredHashLength में supportedHashLengths के अंदर कोई वैल्यू नहीं दी जाती है, तो गड़बड़ी का मैसेज दिखेगा.
|
sizeConstraints |
object (SizeConstraints)
सूची के साइज़ से जुड़ी पाबंदियां. अगर इस एट्रिब्यूट को शामिल नहीं किया जाता है, तो कोई पाबंदी नहीं होती. हमारा सुझाव है कि जिन डिवाइसों में प्रोसेसिंग पावर, बैंडविड्थ या स्टोरेज की कमी है उन पर पाबंदियां लगाएं.
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य हिस्सा
कामयाब रहने पर, जवाब के मुख्य हिस्से में HashList का एक इंस्टेंस शामिल किया जाता है.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-03-06 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-03-06 (UTC) को अपडेट किया गया."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]
