Method: urls.search

পরিচিত হুমকির সাথে মিলে যাওয়া URL গুলি খুঁজুন। প্রতিটি URL এবং এর হোস্ট-সাফিক্স এবং পাথ-প্রিফিক্স এক্সপ্রেশন (সীমিত গভীরতা পর্যন্ত) পরীক্ষা করা হয়। এর অর্থ হল প্রতিক্রিয়ায় এমন URL থাকতে পারে যা অনুরোধে অন্তর্ভুক্ত ছিল না, তবে অনুরোধ করা URL গুলির এক্সপ্রেশন।

HTTP অনুরোধ

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

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

কোয়েরি প্যারামিটার

পরামিতি
urls[]

string

প্রয়োজনীয়। যেসব URL গুলি অনুসন্ধান করতে হবে। ক্লায়েন্টদের ৫০ টির বেশি URL পাঠাতে হবে না।

অনুরোধের মূল অংশ

অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

প্রতিক্রিয়া মূল অংশ

নির্দিষ্ট URL গুলির সাথে মিলে যাওয়া হুমকি অনুসন্ধান করার পরে প্রতিক্রিয়াটি ফিরে এসেছে।

যদি কিছু না পাওয়া যায়, তাহলে সার্ভারটি NOT_FOUND স্ট্যাটাস (HTTP স্ট্যাটাস কোড 404) ফেরত দেওয়ার পরিবর্তে, threats ক্ষেত্রটি খালি রেখে একটি OK স্ট্যাটাস (HTTP স্ট্যাটাস কোড 200) ফেরত দেবে।

যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

JSON উপস্থাপনা 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
ক্ষেত্র
threats[]

object ( ThreatUrl )

অক্রমিক তালিকা। অক্রমিক মিলের হুমকির তালিকা পাওয়া গেছে। প্রতিটি এন্ট্রিতে একটি URL এবং সেই URL এর সাথে মিলে যাওয়া হুমকির ধরণ রয়েছে। তালিকার আকার অনুরোধে থাকা URL এর সংখ্যার চেয়ে বেশি হতে পারে কারণ URL এর সমস্ত এক্সপ্রেশন বিবেচনা করা হত।

cacheDuration

string ( Duration format)

ক্লায়েন্ট-সাইড ক্যাশের সময়কাল। মেয়াদ শেষ হওয়ার সময় নির্ধারণের জন্য ক্লায়েন্টকে অবশ্যই বর্তমান সময়ের সাথে এই সময়কাল যোগ করতে হবে। এরপর ক্লায়েন্টের অনুরোধে জিজ্ঞাসা করা প্রতিটি URL-এর ক্ষেত্রে মেয়াদ শেষ হওয়ার সময় প্রযোজ্য হয়, প্রতিক্রিয়ায় কতগুলি URL ফেরত দেওয়া হোক না কেন। এমনকি যদি সার্ভার কোনও নির্দিষ্ট URL-এর জন্য কোনও মিল না ফেরায়, তবুও এই তথ্যটি ক্লায়েন্টকে ক্যাশে করতে হবে।

যদি এবং শুধুমাত্র যদি ক্ষেত্রটি threats খালি থাকে, তাহলে ক্লায়েন্ট সার্ভার দ্বারা নির্দিষ্ট সময়ের চেয়ে পরে একটি নতুন মেয়াদ নির্ধারণের জন্য cacheDuration বাড়িয়ে দিতে পারে। যেকোনো ক্ষেত্রে, বর্ধিত ক্যাশের সময়কাল 24 ঘন্টার বেশি হওয়া উচিত নয়।

গুরুত্বপূর্ণ: ক্লায়েন্টকে ধরে নেওয়া উচিত নয় যে সার্ভার সমস্ত প্রতিক্রিয়ার জন্য একই ক্যাশে সময়কাল প্রদান করবে। পরিস্থিতির উপর নির্ভর করে সার্ভার বিভিন্ন প্রতিক্রিয়ার জন্য বিভিন্ন ক্যাশে সময়কাল বেছে নিতে পারে।

সেকেন্ডে একটি সময়কাল যার সর্বোচ্চ নয়টি ভগ্নাংশ সংখ্যা ' s ' দিয়ে শেষ হয়। উদাহরণ: "3.5s" ।

থ্রেটইউআরএল

এক বা একাধিক হুমকির সাথে মিলে যাওয়া একটি URL।

JSON উপস্থাপনা 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
ক্ষেত্র
url

string

অনুরোধ করা URL যা এক বা একাধিক হুমকির সাথে মিলেছে।

threatTypes[]

enum ( ThreatType )

অক্রমিক তালিকা। URL-কে যে অক্রমিক হুমকি হিসেবে শ্রেণীবদ্ধ করা হয়েছে তার তালিকা।