Method: urls.search

جستجوی URLهایی که با تهدیدهای شناخته شده مطابقت دارند. هر URL و عبارات پسوند میزبان و پیشوند مسیر آن (تا عمق محدودی) بررسی می‌شوند. این بدان معناست که پاسخ ممکن است شامل URLهایی باشد که در درخواست گنجانده نشده‌اند، اما عباراتی از URLهای درخواستی هستند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
urls[]

string

الزامی. آدرس‌های اینترنتی (URL) که باید جستجو شوند. کلاینت‌ها نباید بیش از ۵۰ آدرس اینترنتی ارسال کنند.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

این پاسخ پس از جستجوی تهدیدهایی که با URL های مشخص شده مطابقت دارند، بازگردانده شد.

اگر چیزی پیدا نشود، سرور به جای بازگرداندن وضعیت NOT_FOUND (کد وضعیت HTTP 404)، وضعیت OK (کد وضعیت HTTP 200) را با فیلد threats خالی برمی‌گرداند.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
فیلدها
threats[]

object ( ThreatUrl )

لیست نامرتب. لیست نامرتب تهدیدات یافت شده. هر ورودی شامل یک URL و انواع تهدیداتی است که با آن URL مطابقت دارند. اندازه لیست می‌تواند بیشتر از تعداد URL های موجود در درخواست باشد، زیرا تمام عبارات URL در نظر گرفته می‌شوند.

cacheDuration

string ( Duration format)

مدت زمان کش سمت کلاینت. کلاینت باید این مدت زمان را به زمان فعلی اضافه کند تا زمان انقضا را تعیین کند. سپس زمان انقضا برای هر URL که توسط کلاینت در درخواست درخواست می‌شود، صرف نظر از تعداد URLهای برگردانده شده در پاسخ، اعمال می‌شود. حتی اگر سرور هیچ تطابقی برای یک URL خاص برنگرداند، این واقعیت نیز باید توسط کلاینت کش شود.

اگر و فقط اگر فیلد threats خالی باشد، کلاینت می‌تواند cacheDuration افزایش دهد تا انقضای جدیدی را تعیین کند که دیرتر از مدت زمان تعیین شده توسط سرور باشد. در هر صورت، مدت زمان افزایش یافته کش نباید بیش از ۲۴ ساعت باشد.

نکته مهم: کلاینت نباید فرض کند که سرور برای همه پاسخ‌ها مدت زمان کش یکسانی را برمی‌گرداند. سرور می‌تواند بسته به شرایط، مدت زمان کش متفاوتی را برای پاسخ‌های مختلف انتخاب کند.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

آدرس تهدید

یک URL که با یک یا چند تهدید مطابقت دارد.

نمایش JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
فیلدها
url

string

آدرس اینترنتی (URL) درخواستی که با یک یا چند تهدید مطابقت داشته است.

threatTypes[]

enum ( ThreatType )

فهرست نامرتب. فهرست نامرتب تهدیدهایی که URL به عنوان آنها طبقه‌بندی شده است.