Method: hashLists.batchGet

একবারে একাধিক হ্যাশ তালিকা পান।

একটি ক্লায়েন্টের জন্য একাধিক হ্যাশ তালিকা পেতে খুব সাধারণ। নিয়মিত Get পদ্ধতি একাধিকবার ব্যবহার করার চেয়ে এই পদ্ধতিটি ব্যবহার করা পছন্দনীয়।

এটি https://google.aip.dev/231 দ্বারা সংজ্ঞায়িত একটি স্ট্যান্ডার্ড ব্যাচ প্রাপ্ত পদ্ধতি এবং HTTP পদ্ধতিটিও GET।

HTTP অনুরোধ

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

ক্যোয়ারী প্যারামিটার

পরামিতি
names[]

string

প্রয়োজন। নির্দিষ্ট হ্যাশ তালিকার নাম. তালিকাটি একটি হুমকি তালিকা হতে পারে, অথবা এটি গ্লোবাল ক্যাশে হতে পারে৷ নামগুলিতে সদৃশ থাকা উচিত নয়; যদি তারা করে, ক্লায়েন্ট একটি ত্রুটি পাবেন।

version[]

string ( bytes format)

হ্যাশ তালিকার সংস্করণ যা ক্লায়েন্ট ইতিমধ্যেই আছে। যদি এই প্রথমবার ক্লায়েন্ট হ্যাশ তালিকা নিয়ে আসে, তাহলে ক্ষেত্রটি খালি রাখা উচিত। অন্যথায়, ক্লায়েন্টকে পূর্বে সার্ভার থেকে প্রাপ্ত সংস্করণ সরবরাহ করতে হবে। ক্লায়েন্ট অবশ্যই সেই বাইটগুলিকে ম্যানিপুলেট করবে না।

ক্লায়েন্টকে সংশ্লিষ্ট তালিকার নামের মতো একই ক্রমে সংস্করণ পাঠাতে হবে না। ক্লায়েন্ট নামের চেয়ে একটি অনুরোধে কম বা বেশি সংস্করণ পাঠাতে পারে। যাইহোক, ক্লায়েন্টকে একই নামের সাথে সঙ্গতিপূর্ণ একাধিক সংস্করণ পাঠাতে হবে না; যদি এটি করে থাকে, ক্লায়েন্ট একটি ত্রুটি পাবে।

ঐতিহাসিক দ্রষ্টব্য: API-এর V4-এ, একে বলা হত states ; স্বচ্ছতার জন্য এটি এখন version নামকরণ করা হয়েছে।

একটি base64-এনকোডেড স্ট্রিং।

desiredHashLength

enum ( HashLength )

বাইটে ফিরে আসা হ্যাশের পছন্দসই হ্যাশ উপসর্গের দৈর্ঘ্য। সার্ভার তারপর এই নির্দিষ্ট দৈর্ঘ্যের সমস্ত হ্যাশ উপসর্গ ফিরিয়ে দেবে।

desiredHashLength ক্ষেত্রের গ্রহণযোগ্য মানগুলির জন্য বিভিন্ন হ্যাশ তালিকার বিভিন্ন প্রয়োজনীয়তা রয়েছে। এটি HashListMetadata supportedHashLengths ফিল্ডে পাওয়া যাবে। যদি desiredHashLength supportedHashLengths মধ্যে একটি মান নির্দিষ্ট না করে, তাহলে ক্লায়েন্টদের কাছে একটি ত্রুটি ফেরত দেওয়া হবে।

বিশেষ করে BatchGetHashListsRequest এর জন্য, ক্লায়েন্টদের জন্য বিভিন্ন তালিকার জন্য একটি ভিন্ন desiredHashLength নির্দিষ্ট করা সম্ভব নয়। যদি এটি করার প্রয়োজন হয়, ক্লায়েন্টকে একাধিক BatchGetHashListsRequest s-এ বিভক্ত করা উচিত।

sizeConstraints

object ( SizeConstraints )

প্রতিটি তালিকার আকারের সীমাবদ্ধতা। যদি বাদ দেওয়া হয়, কোন বাধা নেই। মনে রাখবেন যে এখানে আকারগুলি প্রতি-তালিকা, সমস্ত তালিকা জুড়ে একত্রিত নয়।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

একাধিক হ্যাশ তালিকা ধারণকারী প্রতিক্রিয়া.

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
ক্ষেত্র
hashLists[]

object ( HashList )

অনুরোধে দেওয়া একই ক্রমে হ্যাশ তালিকা।