Method: urls.search

ค้นหา URL ที่ตรงกับภัยคุกคามที่รู้จัก ระบบจะตรวจสอบ URL แต่ละรายการ รวมถึงนิพจน์คำต่อท้ายโฮสต์และคำนำหน้าเส้นทาง (สูงสุดตามระดับที่จำกัด) ซึ่งหมายความว่าการตอบกลับอาจมี URL ที่ไม่ได้รวมอยู่ในคำขอ แต่เป็นนิพจน์ของ URL ที่ขอ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
urls[]

string

ต้องระบุ URL ที่จะค้นหา ไคลเอ็นต์ต้องไม่ส่ง URL เกิน 50 รายการ

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับที่แสดงหลังจากค้นหาภัยคุกคามที่ตรงกับ URL ที่ระบุ

หากไม่พบอะไรเลย เซิร์ฟเวอร์จะแสดงสถานะ OK (รหัสสถานะ HTTP 200) โดยที่ฟิลด์ threats ว่างเปล่า แทนที่จะแสดงสถานะ NOT_FOUND (รหัสสถานะ HTTP 404)

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
ช่อง
threats[]

object (ThreatUrl)

รายการที่ไม่เรียงลำดับ รายการการจับคู่ภัยคุกคามที่พบซึ่งไม่มีการเรียงลำดับ แต่ละรายการจะมี URL และประเภทภัยคุกคามที่พบซึ่งตรงกับ URL นั้น ขนาดรายการอาจมากกว่าจำนวน URL ในคำขอ เนื่องจากระบบจะพิจารณานิพจน์ทั้งหมดของ URL
cacheDuration

string (Duration format)

ระยะเวลาแคชฝั่งไคลเอ็นต์ ไคลเอ็นต์ต้องเพิ่มระยะเวลานี้ลงในเวลาปัจจุบันเพื่อกำหนดเวลาหมดอายุ จากนั้นเวลาหมดอายุจะมีผลกับทุก URL ที่ไคลเอ็นต์ค้นหาในคำขอ ไม่ว่าการตอบกลับจะแสดง URL กี่รายการก็ตาม แม้ว่าเซิร์ฟเวอร์จะไม่พบรายการที่ตรงกันสำหรับ URL ใด URL หนึ่ง แต่ไคลเอ็นต์ก็ต้องแคชข้อเท็จจริงนี้ด้วย

หากฟิลด์ threats ว่างเปล่าเท่านั้น ไคลเอ็นต์อาจเพิ่ม cacheDuration เพื่อกำหนดวันหมดอายุใหม่ที่หลังจากวันที่เซิร์ฟเวอร์ระบุ ไม่ว่าในกรณีใดก็ตาม ระยะเวลาแคชที่เพิ่มขึ้นต้องไม่เกิน 24 ชั่วโมง

สำคัญ: ไคลเอ็นต์ต้องไม่ถือว่าเซิร์ฟเวอร์จะแสดงระยะเวลาแคชเดียวกันสำหรับการตอบกลับทั้งหมด เซิร์ฟเวอร์อาจเลือกระยะเวลาแคชที่แตกต่างกันสำหรับการตอบกลับที่แตกต่างกันได้ ทั้งนี้ขึ้นอยู่กับสถานการณ์

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"

ThreatUrl

URL ที่ตรงกับภัยคุกคามอย่างน้อย 1 รายการ

การแสดง JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
ช่อง
url

string

URL ที่ขอซึ่งตรงกับภัยคุกคามอย่างน้อย 1 รายการ
threatTypes[]

enum (ThreatType)

รายการที่ไม่เรียงลำดับ รายการภัยคุกคามที่ไม่มีการเรียงลำดับซึ่ง URL จัดอยู่ในประเภท