Method: urls.search

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

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

GET https://safebrowsing.googleapis.com/v5/urls:search

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

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

पैरामीटर
urls[]

string

ज़रूरी है. वे यूआरएल जिनकी जानकारी देखनी है. क्लाइंट को 50 से ज़्यादा यूआरएल नहीं भेजने चाहिए.

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

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

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

यह जवाब, बताए गए यूआरएल से मिलती-जुलती थ्रेट खोजने के बाद मिलता है.

अगर कुछ भी नहीं मिलता है, तो सर्वर, NOT_FOUND स्टेटस (एचटीटीपी स्टेटस कोड 404) दिखाने के बजाय, OK स्टेटस (एचटीटीपी स्टेटस कोड 200) दिखाएगा. साथ ही, threats फ़ील्ड खाली होगा.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
फ़ील्ड
threats[]

object (ThreatUrl)

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

string (Duration format)

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

अगर फ़ील्ड threats खाली है, तो क्लाइंट cacheDuration की वैल्यू बढ़ा सकता है. इससे, सर्वर की ओर से तय की गई समयसीमा के बाद की नई समयसीमा तय की जा सकती है. किसी भी स्थिति में, कैश मेमोरी में सेव रहने की अवधि 24 घंटे से ज़्यादा नहीं होनी चाहिए.

अहम जानकारी: क्लाइंट को यह नहीं मानना चाहिए कि सर्वर, सभी जवाबों के लिए कैश मेमोरी में सेव रहने की अवधि एक जैसी रखेगा. सर्वर, स्थिति के हिसाब से अलग-अलग जवाबों के लिए, कैश मेमोरी में सेव रखने की अलग-अलग अवधि चुन सकता है.

यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में 's' होता है. उदाहरण: "3.5s".

ThreatUrl

ऐसा यूआरएल जो एक या उससे ज़्यादा खतरों से मेल खाता हो.

JSON के काेड में दिखाना 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
फ़ील्ड
url

string

अनुरोध किया गया वह यूआरएल जिससे एक या उससे ज़्यादा खतरों का पता चला है.
threatTypes[]

enum (ThreatType)

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