เอกสารนี้ใช้กับวิธีการต่อไปนี้ Update API (v4): threatListUpdates.fetch
การตั้งค่าข้อจำกัด
เมื่ออัปเดตฐานข้อมูลภายใน
(ดูการอัปเดตฐานข้อมูล)
ไคลเอ็นต์จะใช้ช่อง maxUpdateEntries
และ maxDatabaseEntries
ใน
คำขอ threatListUpdates.fetch
เพื่อระบุข้อจำกัดด้านขนาดได้ ไคลเอ็นต์ควรกำหนดข้อจำกัดเพื่อรักษาการใช้ RAM, ดิสก์ และแบนด์วิดท์ของไคลเอ็นต์แบบคาดเดาได้ รวมถึงเพื่อป้องกันการเพิ่มขึ้นของรายการ
- ไคลเอ็นต์จะระบุขนาดการตอบกลับสูงสุดของการอัปเดตได้ (
maxUpdateEntries
) ตามจำนวนรายการ (1 รายการ = เพิ่ม 1 รายการหรือนำออก 1 รายการ) - ไคลเอ็นต์จะระบุขนาดสูงสุดของฐานข้อมูล (
maxDatabaseEntries
) ได้หลายรายการ (รายการส่วนใหญ่ในฐานข้อมูลเป็นคำนำหน้าแฮชแบบ 4 ไบต์ จึงถือว่าเหมาะสมที่จะสมมติว่า 1 รายการ ≈ 4 ไบต์)
แบนด์วิดท์เทียบกับพื้นที่เก็บข้อมูล
แม้ว่าไคลเอ็นต์จะระบุขนาดที่กำหนดเองสำหรับการตอบสนองของการอัปเดตและขนาดฐานข้อมูล แต่เซิร์ฟเวอร์ Safe Browsing จะสร้างคำตอบในการอัปเดตและขนาดฐานข้อมูลให้ล่วงหน้าเป็นจำนวนที่จำกัดเท่านั้น
- ไคลเอ็นต์ควรใช้ขนาดการตอบสนองของการอัปเดต (
maxUpdateEntries
) เพื่อจำกัดการใช้งานแบนด์วิดท์ - ไคลเอ็นต์ควรใช้ขนาดฐานข้อมูล (
maxDatabaseEntries
) เพื่อจำกัดจำนวน RAM หรือพื้นที่เก็บข้อมูลในดิสก์ที่อุปกรณ์ต้องใช้
คำแนะนำสำหรับการกำหนดข้อจำกัด
รายการ Google Safe Browsing สามารถค่อยๆ เปลี่ยนขนาดหรือค่อยๆ เปลี่ยนแปลงไปได้ ไคลเอ็นต์ควรตั้งค่า maxUpdateEntries
สำหรับคำขออัปเดตรายการ ซึ่งจะจำกัดขนาดการตอบกลับการอัปเดตรายการสูงสุดและปรับปรุงความน่าเชื่อถือเมื่อประมวลผลการอัปเดตขนาดใหญ่ไม่ได้
ในกรณีที่ไม่มีข้อกำหนดที่เข้มงวดกว่าหรือข้อกำหนดที่เข้มงวดน้อยกว่า Google ขอแนะนำให้ใช้ maxUpdateEntries=16777216
ด้วยขนาดรายการทั่วไปที่ 4 ไบต์ต่อคำนำหน้าแฮช ซึ่งเท่ากับประมาณ 67 เมกะไบต์ต่อรายการ Google ขอแนะนำให้ใช้ขีดจำกัดที่น้อยกว่า maxUpdateEntries=2097152
สำหรับไคลเอ็นต์อุปกรณ์เคลื่อนที่ เนื่องจากมักจะมีประสิทธิภาพน้อยกว่า ที่ขนาดข้อมูลรายการทั่วไปที่ 4 ไบต์ต่อคำนำหน้าแฮช ซึ่งเท่ากับประมาณ 8 เมกะไบต์ต่อรายการ
รายการ Google Safe Browsing มีขนาดและอัตราการเติบโตแตกต่างกัน อย่างไรก็ตาม ไคลเอ็นต์ควรตั้งข้อจำกัดเดียวกันสำหรับรายการทั้งหมด โดยอิงตามการใช้หน่วยความจำหรือแบนด์วิดท์สูงสุดที่อนุญาตสำหรับแต่ละรายการ
Google ขอแนะนำให้ไคลเอ็นต์ใช้การวัดและส่งข้อมูลทางไกลในการตรวจหาการใช้หน่วยความจำหรือแบนด์วิดท์ที่มากเกินไป รวมถึงกลไกต่างๆ ในการส่งข้อจำกัดใหม่ไปยังไคลเอ็นต์อย่างรวดเร็วเพื่อปรับปรุงความน่าเชื่อถือ
สถานะไคลเอ็นต์
เซิร์ฟเวอร์ Google Safe Browsing จะไม่ส่งอัปเดตที่ปล่อยให้ไคลเอ็นต์อยู่ในสถานะล้าสมัย ไคลเอ็นต์จะได้รับข้อมูลอัปเดตทั้งหมดหลังจากคําขออัปเดตทุกครั้ง เช่น หากปัจจุบันไคลเอ็นต์มีฐานข้อมูล รายการ 4, 096 รายการ แต่ต้องการดาวน์โหลดเดลต้าไม่เกิน 2, 048 รายการเท่านั้น เซิร์ฟเวอร์อาจรีเซ็ตไคลเอ็นต์เป็นฐานข้อมูล 2048 หากไคลเอ็นต์ไม่เป็นปัจจุบันจริงๆ