Method: hashList.get

אחזור התוכן העדכני ביותר של רשימת גיבוב. רשימת גיבוב יכולה להיות רשימת איומים או רשימה שאינה רשימת איומים, כמו Global Cache.

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

פרמטרים
version

string (bytes format)

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

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

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

enum (HashLength)

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

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

object (SizeConstraints)

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

גוף הבקשה

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

גוף התשובה

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