Method: hashLists.batchGet

چندین لیست هش را به طور همزمان دریافت می‌کند.

خیلی رایج است که یک کلاینت نیاز به دریافت چندین لیست هش داشته باشد. استفاده از این روش نسبت به استفاده‌ی مکرر از روش 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)

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

کلاینت نیازی ندارد نسخه‌ها را به همان ترتیب نام‌های لیست مربوطه ارسال کند. کلاینت می‌تواند در یک درخواست، نسخه‌های کمتر یا بیشتری نسبت به نام‌های موجود ارسال کند. با این حال، کلاینت نباید چندین نسخه که با یک نام مطابقت دارند را ارسال کند؛ در این صورت، کلاینت با خطا مواجه خواهد شد.

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

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

sizeConstraints

object ( SizeConstraints )

محدودیت‌های اندازه در هر لیست. اگر حذف شود، هیچ محدودیتی وجود ندارد. توجه داشته باشید که اندازه‌ها در اینجا برای هر لیست هستند، نه برای همه لیست‌ها.

درخواست بدنه

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

بدنه پاسخ

پاسخی که حاوی چندین لیست هش است.

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

نمایش JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
فیلدها
hashLists[]

object ( HashList )

هش به همان ترتیبی که در درخواست داده شده است، فهرست می‌شود.