Method: hashLists.list

لیست‌های هش را لیست می‌کند.

در API نسخه ۵، گوگل هرگز لیست هشی را که قبلاً توسط این روش برگردانده شده است، حذف نمی‌کند. این امر به کلاینت‌ها این امکان را می‌دهد که از استفاده از این روش صرف نظر کرده و تمام لیست‌های هشی مورد نیاز خود را به سادگی در کدنویسی ثابت (hardcode) کنند.

این یک روش استاندارد List است که توسط https://google.aip.dev/132 تعریف شده است و روش HTTP آن GET است.

درخواست HTTP

GET https://safebrowsing.googleapis.com/v5/hashLists

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

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

پارامترها
pageSize

integer

حداکثر تعداد فهرست‌های هش برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، سرور اندازه صفحه‌ای را انتخاب می‌کند که ممکن است بزرگتر از تعداد فهرست‌های هش باشد تا نیازی به صفحه‌بندی نباشد.

pageToken

string

یک توکن صفحه، که از فراخوانی hashLists.list قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

درخواست بدنه

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

بدنه پاسخ

پاسخی که شامل فراداده‌هایی در مورد فهرست‌های درهم‌سازی است.

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

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

object ( HashList )

هش‌ها به ترتیب دلخواه فهرست می‌شوند. فقط فراداده‌های مربوط به فهرست‌های هش درج می‌شوند، نه محتویات آنها.

nextPageToken

string

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