Method: urls.search

Bilinen tehditlerle eşleşen URL'leri arama Her URL, ana makine soneki ve yol öneki ifadeleri (sınırlı derinliğe kadar) kontrol edilir. Bu, yanıtın, istekte yer almayan ancak istenen URL'lerin ifadeleri olan URL'ler içerebileceği anlamına gelir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
urls[]

string

Zorunlu. Aranacak URL'ler. Müşteriler 50'den fazla URL göndermemelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Belirtilen URL'lerle eşleşen tehditler arandıktan sonra döndürülen yanıt.

Hiçbir şey bulunamazsa sunucu, NOT_FOUND durumu (HTTP durum kodu 404) döndürmek yerine threats alanı boş olarak OK durumu (HTTP durum kodu 200) döndürür.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Alanlar
threats[]

object (ThreatUrl)

Sırasız liste. Bulunan tehdit eşleşmelerinin sırasız listesi. Her giriş bir URL ve bu URL ile eşleşen tehdit türlerini içerir. URL'nin tüm ifadeleri dikkate alındığından liste boyutu, istekteki URL sayısından büyük olabilir.
cacheDuration

string (Duration format)

İstemci tarafı önbellek süresi. İstemci, geçerlilik bitiş zamanını belirlemek için bu süreyi geçerli zamana EKLEMELİDİR. Son kullanma süresi, yanıtta kaç URL döndürüldüğünden bağımsız olarak, istemci tarafından istekte sorgulanan her URL için geçerli olur. Sunucu, belirli bir URL için eşleşme döndürmese bile bu durum istemci tarafından önbelleğe alınmalıdır.

Yalnızca threats alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir yeni son kullanma tarihi belirlemek için cacheDuration değerini artırabilir. Her durumda, artırılan önbellek süresi 24 saatten uzun olmamalıdır.

Önemli: İstemci, sunucunun tüm yanıtlar için aynı önbellek süresini döndüreceğini VARSAYMAMALIDIR. Sunucu, duruma bağlı olarak farklı yanıtlar için farklı önbellek süreleri seçebilir.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

ThreatUrl

Bir veya daha fazla tehditle eşleşen bir URL

JSON gösterimi 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Alanlar
url

string

Bir veya daha fazla tehditle eşleşen istenen URL.
threatTypes[]

enum (ThreatType)

Sırasız liste. URL'nin sınıflandırıldığı tehditlerin sırasız listesi.