Method: hashLists.batchGet

รับรายการแฮชหลายรายการพร้อมกัน

การที่ลูกค้าจำเป็นต้องมีรายการแฮชหลายรายการนั้นเป็นเรื่องปกติ เราขอแนะนำให้ใช้วิธีการนี้มากกว่าการใช้เมธอด "รับ" ปกติหลายๆ ครั้ง

วิธีนี้เป็นวิธี Get แบบกลุ่มมาตรฐานตามที่กำหนดโดย https://google.aip.dev/231 และเมธอด HTTP ก็คือ GET เช่นกัน

คำขอ HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

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

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

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

string

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

string (bytes format)

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

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

หมายเหตุตลอดช่วงเวลา: ใน V4 ของ API ข้อมูลนี้ใช้ชื่อว่า states ตอนนี้ได้เปลี่ยนชื่อเป็น version เพื่อความชัดเจน

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

enum (HashLength)

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

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

โดยเฉพาะอย่างยิ่งสำหรับ BatchGetHashListsRequest ลูกค้าไม่สามารถระบุ desiredHashLength ที่แตกต่างกันสำหรับรายการต่างๆ ได้ หากจำเป็นต้องดำเนินการดังกล่าว ลูกค้าควรแบ่งออกเป็น BatchGetHashListsRequest หลายรายการ
sizeConstraints

object (SizeConstraints)

ข้อจำกัดด้านขนาดในแต่ละรายการ หากละไว้ จะไม่มีข้อจำกัดใดๆ โปรดทราบว่าขนาดที่ระบุนี้เป็นขนาดต่อรายการ ไม่ใช่รวมในรายการทั้งหมด

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

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

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

การตอบกลับที่มีรายการแฮชหลายรายการ

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

การแสดง JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
ช่อง
hashLists[]

object (HashList)

รายการแฮชจะเรียงลำดับตามที่ให้ไว้ในคำขอ