Method: hashList.get

آخرین محتویات یک لیست هش را دریافت می‌کند. یک لیست هش می‌تواند شامل یک لیست تهدید یا یک لیست غیر تهدید مانند Global Cache باشد.

این یک روش استاندارد Get است که توسط https://google.aip.dev/131 تعریف شده است و روش HTTP نیز GET است.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام این فهرست هش خاص. ممکن است یک فهرست تهدید یا ممکن است حافظه پنهان سراسری باشد.

پارامترهای پرس و جو

پارامترها
version

string ( bytes format)

نسخه‌ای از لیست هش که کلاینت از قبل دارد. اگر این اولین باری است که کلاینت لیست هش را دریافت می‌کند، این فیلد باید خالی بماند. در غیر این صورت، کلاینت باید نسخه‌ای را که قبلاً از سرور دریافت کرده است، ارائه دهد. کلاینت نباید آن بایت‌ها را دستکاری کند.

ویژگی‌های جدید در نسخه ۵ : در نسخه ۴ این API، این states نام داشت؛ اکنون برای وضوح بیشتر به version تغییر نام داده شده است.

یک رشته کدگذاری شده با base64.

sizeConstraints

object ( SizeConstraints )

محدودیت‌های اندازه در لیست. در صورت حذف، هیچ محدودیتی وجود ندارد. اعمال محدودیت‌ها در تمام دستگاه‌هایی با قدرت پردازش، پهنای باند یا فضای ذخیره‌سازی محدود توصیه می‌شود.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از HashList است.