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

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

string (bytes format)

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

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

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

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

enum (HashLength)

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

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

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

object (SizeConstraints)

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

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

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

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

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

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

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

object (HashList)

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