Method: hashList.get

รับเนื้อหาล่าสุดของรายการแฮช รายการแฮชอาจอิงตามรายการภัยคุกคามหรือรายการที่ไม่ใช่ภัยคุกคาม เช่น แคชทั่วโลก

ซึ่งเป็นเมธอด Get มาตรฐานตามที่กำหนดโดย https://google.aip.dev/131 และเมธอด HTTP ก็ใช้ GET เช่นกัน

คำขอ HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อของรายการแฮชนี้ โดยอาจเป็นรายการภัยคุกคาม หรืออาจเป็น Global Cache

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

พารามิเตอร์
version

string (bytes format)

เวอร์ชันของรายการแฮชที่ไคลเอ็นต์มีอยู่แล้ว หากไคลเอ็นต์ดึงข้อมูลรายการแฮชเป็นครั้งแรก ช่องนี้ต้องเว้นว่างไว้ ไม่เช่นนั้น ไคลเอ็นต์ควรจัดหาเวอร์ชันที่ได้รับมาจากเซิร์ฟเวอร์ก่อนหน้านี้ ไคลเอ็นต์ต้องไม่จัดการกับไบต์เหล่านั้น

มีอะไรใหม่ใน V5: ใน API เวอร์ชัน 4 โดยใช้ชื่อว่า states และตอนนี้เปลี่ยนชื่อเป็น version เพื่อความชัดเจน

สตริงที่เข้ารหัสฐาน 64
desiredHashLength

enum (HashLength)

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

รายการแฮชที่ต่างกันมีข้อกำหนดที่แตกต่างกันเกี่ยวกับค่าที่ยอมรับได้ของช่อง desiredHashLength จะอยู่ในช่อง supportedHashLengths ใน HashListMetadata หาก desiredHashLength ไม่ได้ระบุค่าภายใน supportedHashLengths ระบบจะแสดงข้อผิดพลาด
sizeConstraints

object (SizeConstraints)

ข้อจำกัดด้านขนาดในรายการ หากไม่ระบุ จะไม่มีข้อจำกัดใดๆ ขอแนะนำให้ใช้ข้อจำกัดในอุปกรณ์ทั้งหมดที่ใช้พลังงานในการประมวลผล แบนด์วิดท์ หรือพื้นที่เก็บข้อมูลที่จำกัด

เนื้อหาของคำขอ

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ HashList