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 เรียก API นี้ว่า states แต่ตอนนี้เปลี่ยนชื่อเป็น version เพื่อให้ชัดเจน

สตริงที่เข้ารหัส Base64
desiredHashLength
(deprecated)

enum (HashLength)

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

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

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

object (SizeConstraints)

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

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

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

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

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

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

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

object (HashList)

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