Method: hashLists.batchGet

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

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

นี่คือเมธอด 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)

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

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

หมายเหตุเกี่ยวกับประวัติ: ใน API เวอร์ชัน 4 เราเรียกพารามิเตอร์นี้ว่า states แต่ตอนนี้เราได้เปลี่ยนชื่อเป็น version เพื่อให้เข้าใจได้ง่ายขึ้น

สตริงที่เข้ารหัส Base64
sizeConstraints

object (SizeConstraints)

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

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

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

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

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

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

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

object (HashList)

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