Method: hashLists.batchGet

אחזור של כמה רשימות גיבוב בבת אחת.

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

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

בקשת HTTP

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

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

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

פרמטרים
names[]

string

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

string (bytes format)

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

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

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

מחרוזת בקידוד Base64.
desiredHashLength
(deprecated)

enum (HashLength)

אורך הקידומת הרצוי של הגיבוב (hash) של הגיבובים שמוחזרים, בבייטים. לאחר מכן, השרת יחזיר את כל תחיליות הגיבוב באורך שצוין.

לרשימות גיבוב שונות יש דרישות שונות לגבי הערכים הקבילים בשדה desiredHashLength. אפשר למצוא אותו בשדה supportedHashLengths ב-HashListMetadata. אם לא צוין ערך ב-desiredHashLength בתוך supportedHashLengths, תוחזר שגיאה ללקוחות.

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

object (SizeConstraints)

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (HashList)

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