Method: urls.search

Menelusuri URL yang cocok dengan ancaman yang diketahui. Setiap URL dan ekspresi akhiran host serta awalan jalur (hingga kedalaman terbatas) diperiksa. Artinya, respons dapat berisi URL yang tidak disertakan dalam permintaan, tetapi merupakan ekspresi dari URL yang diminta.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
urls[]

string

Wajib. URL yang akan dicari. Klien TIDAK BOLEH mengirim lebih dari 50 URL.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons yang ditampilkan setelah menelusuri ancaman yang cocok dengan URL yang ditentukan.

Jika tidak ada yang ditemukan, server akan menampilkan status OK (kode status HTTP 200) dengan kolom threats kosong, bukan menampilkan status NOT_FOUND (kode status HTTP 404).

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Kolom
threats[]

object (ThreatUrl)

Daftar yang tidak diurutkan. Daftar kecocokan ancaman yang ditemukan dan tidak berurutan. Setiap entri berisi URL dan jenis ancaman yang ditemukan cocok dengan URL tersebut. Ukuran daftar dapat lebih besar daripada jumlah URL dalam permintaan karena semua ekspresi URL akan dipertimbangkan.
cacheDuration

string (Duration format)

Durasi cache sisi klien. Klien HARUS menambahkan durasi ini ke waktu saat ini untuk menentukan waktu habis masa berlaku. Waktu habis masa berlaku kemudian berlaku untuk setiap URL yang dikueri oleh klien dalam permintaan, terlepas dari jumlah URL yang ditampilkan dalam respons. Meskipun server tidak menampilkan kecocokan untuk URL tertentu, fakta ini JUGA HARUS di-cache oleh klien.

Jika dan hanya jika kolom threats kosong, klien DAPAT meningkatkan cacheDuration untuk menentukan masa berlaku baru yang lebih lama daripada yang ditentukan oleh server. Bagaimanapun, durasi cache yang ditingkatkan tidak boleh lebih dari 24 jam.

Penting: klien TIDAK BOLEH mengasumsikan bahwa server akan menampilkan durasi cache yang sama untuk semua respons. Server DAPAT memilih durasi cache yang berbeda untuk respons yang berbeda, bergantung pada situasinya.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

ThreatUrl

URL yang cocok dengan satu atau beberapa ancaman.

Representasi JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Kolom
url

string

URL yang diminta dan cocok dengan satu atau beberapa ancaman.
threatTypes[]

enum (ThreatType)

Daftar yang tidak diurutkan. Daftar ancaman tidak berurutan yang diklasifikasikan sebagai URL.