Method: hashLists.batchGet

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

לעיתים קרובות לקוח צריך לקבל כמה רשימות גיבוב (hash). עדיף להשתמש בשיטה הזו על פני שיטת 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)

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

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

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

מחרוזת בקידוד base64.

desiredHashLength

enum (HashLength)

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

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

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

sizeConstraints

object (SizeConstraints)

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (HashList)

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