Method: hashList.get

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

זוהי שיטת Get סטנדרטית, כפי שמוגדר על ידי https://google.aip.dev/131 ושיטת ה-HTTP היא גם GET.

בקשת HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
name

string

חובה. השם של רשימת הגיבוב הספציפית הזו. זו יכולה להיות רשימת איומים או המטמון הגלובלי.

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

פרמטרים
version

string (bytes format)

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

מה חדש ב-V5: ב-V4 של ה-API, שם ה-API נקרא states; ועכשיו הוא נקרא version לשם הבהרה.

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

enum (HashLength)

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

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

object (SizeConstraints)

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

גוף הבקשה

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

גוף התשובה

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