Method: urls.search

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

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

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

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

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

पैरामीटर
urls[]

string

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

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

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

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

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

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

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

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)

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