Method: hashLists.batchGet

מקבל מספר רשימות גיבוב בבת אחת.

בדרך כלל לקוח צריך לקבל כמה רשימות גיבוב. מומלץ להשתמש בשיטה הזו במקום להשתמש בשיטת Get הרגילה מספר פעמים.

זו שיטה רגילה של קבלת נתונים (Get) בקבוצות, כפי שמוגדר בכתובת https://google.aip.dev/231, ושיטת ה-HTTP היא גם GET.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
names[]

string

חובה. השמות של רשימות הגיבוב הספציפיות. הרשימה יכולה להיות רשימת איומים, או יכולה להיות המטמון הגלובלי. השמות לא יכולים להיות כפולים. אם הם כפולים, הלקוח יקבל שגיאה.
version[]

string (bytes format)

הגרסאות של רשימת הגיבוב שכבר קיימות אצל הלקוח. אם זו הפעם הראשונה שהלקוח מאחזר את רשימות הגיבוב, צריך להשאיר את השדה הזה ריק. אחרת, הלקוח צריך לספק את הגרסאות שהתקבלו קודם מהשרת. הלקוח לא יכול לשנות את הבייטים האלה.

הלקוח לא צריך לשלוח את הגרסאות באותו סדר כמו שמות הרשימות התואמות. יכול להיות שהלקוח ישלח בבקשה פחות או יותר גרסאות מהמספר של השמות. עם זאת, הלקוח לא יכול לשלוח כמה גרסאות שמתאימות לאותו שם. אם הוא יעשה זאת, הוא יקבל שגיאה.

הערה היסטורית: בגרסה 4 של ה-API, השם היה states. עכשיו השם הוא version, כדי שיהיה ברור יותר.

מחרוזת בקידוד Base64.
sizeConstraints

object (SizeConstraints)

מגבלות הגודל של כל רשימה. אם לא מציינים ערך, אין אילוצים. הערה: הגדלים שמופיעים כאן הם לכל רשימה, ולא נתונים מצטברים של כל הרשימות.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

התשובה מכילה כמה רשימות של ערכי גיבוב.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
שדות
hashLists[]

object (HashList)

רשימות הגיבובים באותו סדר שצוין בבקשה.