REST Resource: hashList

রিসোর্স: হ্যাশলিস্ট

এর নাম দ্বারা চিহ্নিত হ্যাশের একটি তালিকা।

JSON উপস্থাপনা 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": string,
  "sha256Checksum": string,
  "metadata": {
    object (HashListMetadata)
  },

  // Union field compressed_additions can be only one of the following:
  "additionsFourBytes": {
    object (RiceDeltaEncoded32Bit)
  },
  "additionsEightBytes": {
    object (RiceDeltaEncoded64Bit)
  },
  "additionsSixteenBytes": {
    object (RiceDeltaEncoded128Bit)
  },
  "additionsThirtyTwoBytes": {
    object (RiceDeltaEncoded256Bit)
  }
  // End of list of possible types for union field compressed_additions.
}
ক্ষেত্র
name

string

হ্যাশ তালিকার নাম। মনে রাখবেন যে গ্লোবাল ক্যাশেও কেবল একটি হ্যাশ তালিকা এবং এখানে উল্লেখ করা যেতে পারে।

version

string ( bytes format)

হ্যাশ তালিকার সংস্করণ। ক্লায়েন্টকে অবশ্যই সেই বাইটগুলি ম্যানিপুলেট করতে হবে না।

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

partialUpdate

boolean

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

যখন মিথ্যা হয়, তখন ক্লায়েন্টকে এই হ্যাশ তালিকার জন্য স্থানীয়ভাবে সংরক্ষিত যেকোনো সংস্করণ মুছে ফেলতে হবে। এর অর্থ হল ক্লায়েন্টের কাছে থাকা সংস্করণটি গুরুতরভাবে পুরানো, অথবা ক্লায়েন্টের ডেটা দূষিত বলে মনে করা হচ্ছে। compressedRemovals ক্ষেত্রটি খালি থাকবে।

যখন সত্য হয়, তখন ক্লায়েন্টকে অপসারণ এবং তারপর সংযোজন প্রয়োগ করে একটি ক্রমবর্ধমান আপডেট প্রয়োগ করতে হবে।

compressedRemovals

object ( RiceDeltaEncoded32Bit )

অপসারণ সূচকের রাইস-ডেল্টা এনকোডেড সংস্করণ। যেহেতু প্রতিটি হ্যাশ তালিকায় অবশ্যই 2^32 এর কম এন্ট্রি থাকে, তাই সূচকগুলিকে 32-বিট পূর্ণসংখ্যা হিসাবে বিবেচনা করা হয় এবং এনকোড করা হয়।

minimumWaitDuration

string ( Duration format)

ক্লায়েন্টদের হ্যাশ তালিকাটি আবার পেতে কমপক্ষে এতক্ষণ অপেক্ষা করা উচিত। যদি বাদ দেওয়া হয় বা শূন্য হয়, তাহলে ক্লায়েন্টদের অবিলম্বে আনতে হবে কারণ এটি নির্দেশ করে যে সার্ভারের ক্লায়েন্টকে একটি অতিরিক্ত আপডেট পাঠানোর আছে, কিন্তু ক্লায়েন্ট-নির্দিষ্ট সীমাবদ্ধতার কারণে তা সম্ভব হয়নি।

সেকেন্ডে একটি সময়কাল যার সর্বোচ্চ নয়টি ভগ্নাংশ সংখ্যা ' s ' দিয়ে শেষ হয়। উদাহরণ: "3.5s" ।

sha256Checksum

string ( bytes format)

সমস্ত হ্যাশের সাজানো তালিকা, SHA256 দিয়ে আবার হ্যাশ করা হয়েছে। প্রদত্ত আপডেট প্রয়োগ করার পরে ডাটাবেসে উপস্থিত সমস্ত হ্যাশের সাজানো তালিকার জন্য এটি চেকসাম। যদি কোনও আপডেট সরবরাহ করা না হয়, তবে ক্লায়েন্টের বিদ্যমান চেকসাম ব্যবহার করা উচিত তা নির্দেশ করার জন্য সার্ভার এই ক্ষেত্রটি বাদ দেবে।

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

metadata

object ( HashListMetadata )

হ্যাশ তালিকা সম্পর্কে মেটাডেটা। এটি hashList.get পদ্ধতি দ্বারা পূরণ করা হয় না, তবে এটি ListHashLists পদ্ধতি দ্বারা পূরণ করা হয়।

Union ফিল্ড compressed_additions । রাইস-ডেল্টা এনকোডেড সংযোজন সংস্করণ। তালিকার সমস্ত সংযোজনে সংযোজনের হ্যাশ প্রিফিক্স দৈর্ঘ্য অভিন্ন। compressed_additions নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
additionsFourBytes

object ( RiceDeltaEncoded32Bit )

৪-বাইট সংযোজন।

additionsEightBytes

object ( RiceDeltaEncoded64Bit )

৮-বাইট সংযোজন।

additionsSixteenBytes

object ( RiceDeltaEncoded128Bit )

১৬-বাইট সংযোজন।

additionsThirtyTwoBytes

object ( RiceDeltaEncoded256Bit )

৩২-বাইট সংযোজন।

রাইসডেল্টাএনকোডেড৩২বিট

রাইস-গোলম্ব এনকোডেড ডেটা। হ্যাশ বা অপসারণ সূচকের জন্য ব্যবহৃত হয়। এটি নিশ্চিত যে এখানে প্রতিটি হ্যাশ বা সূচকের দৈর্ঘ্য একই, এবং এই দৈর্ঘ্য ঠিক 32 বিট।

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

ঐতিহাসিক দ্রষ্টব্য: এই API-এর V4-তে প্রথমে রাইস-ডেল্টা এনকোডিং ব্যবহার করা হয়েছিল। V5-তে, দুটি উল্লেখযোগ্য উন্নতি করা হয়েছিল: প্রথমত, রাইস-ডেল্টা এনকোডিং এখন 4 বাইটের বেশি লম্বা হ্যাশ প্রিফিক্স সহ উপলব্ধ; দ্বিতীয়ত, এনকোড করা ডেটা এখন বিগ-এন্ডিয়ান হিসাবে বিবেচিত হয় যাতে ব্যয়বহুল বাছাইয়ের পদক্ষেপ এড়ানো যায়।

JSON উপস্থাপনা 
{
  "firstValue": integer,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ক্ষেত্র
firstValue

integer ( uint32 format)

এনকোড করা ডেটার প্রথম এন্ট্রি (হ্যাশ বা সূচক), অথবা, যদি শুধুমাত্র একটি হ্যাশ প্রিফিক্স বা সূচক এনকোড করা থাকে, তাহলে সেই এন্ট্রির মান। যদি ক্ষেত্রটি খালি থাকে, তাহলে এন্ট্রিটি শূন্য হবে।

riceParameter

integer

গোলম্ব-রাইস প্যারামিটার। এই প্যারামিটারটি ৩ থেকে ৩০ এর মধ্যে হবে বলে নিশ্চিত করা হচ্ছে, সমেত।

entriesCount

integer

এনকোড করা ডেটাতে ডেল্টা এনকোড করা এন্ট্রির সংখ্যা। যদি শুধুমাত্র একটি পূর্ণসংখ্যা এনকোড করা থাকে, তাহলে এটি শূন্য হবে এবং একক মানটি firstValue তে সংরক্ষণ করা হবে।

encodedData

string ( bytes format)

গোলম্ব-রাইস কোডার ব্যবহার করে এনকোড করা এনকোডেড ডেল্টা।

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

রাইসডেল্টাএনকোডেড64বিট

RiceDeltaEncoded32Bit এর মতোই, তবে এটি 64-বিট সংখ্যা এনকোড করে।

JSON উপস্থাপনা 
{
  "firstValue": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ক্ষেত্র
firstValue

string

এনকোড করা ডেটার প্রথম এন্ট্রি (হ্যাশ), অথবা, যদি শুধুমাত্র একটি হ্যাশ প্রিফিক্স এনকোড করা থাকে, তাহলে সেই এন্ট্রির মান। যদি ক্ষেত্রটি খালি থাকে, তাহলে এন্ট্রিটি শূন্য হবে।

riceParameter

integer

গোলম্ব-রাইস প্যারামিটার। এই প্যারামিটারটি 35 এবং 62 এর মধ্যে হবে বলে নিশ্চিত করা হচ্ছে, সমেত।

entriesCount

integer

এনকোড করা ডেটাতে ডেল্টা এনকোড করা এন্ট্রির সংখ্যা। যদি শুধুমাত্র একটি পূর্ণসংখ্যা এনকোড করা থাকে, তাহলে এটি শূন্য হবে এবং একক মানটি firstValue তে সংরক্ষণ করা হবে।

encodedData

string ( bytes format)

গোলম্ব-রাইস কোডার ব্যবহার করে এনকোড করা এনকোডেড ডেল্টা।

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

রাইসডেল্টাএনকোডেড১২৮বিট

RiceDeltaEncoded32Bit এর মতোই, তবে এটি 128-বিট সংখ্যা এনকোড করে।

JSON উপস্থাপনা 
{
  "firstValueHi": string,
  "firstValueLo": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ক্ষেত্র
firstValueHi

string

এনকোডেড ডেটাতে প্রথম এন্ট্রির উপরের ৬৪ বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে উপরের ৬৪ বিটগুলি সব শূন্য হবে।

firstValueLo

string ( uint64 format)

এনকোডেড ডেটাতে প্রথম এন্ট্রির নিচের ৬৪ বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে নিচের ৬৪ বিটগুলি সবই শূন্য হবে।

riceParameter

integer

গোলম্ব-রাইস প্যারামিটার। এই প্যারামিটারটি ৯৯ এবং ১২৬ এর মধ্যে হবে বলে নিশ্চিত করা হচ্ছে, সমেত।

entriesCount

integer

এনকোড করা ডেটাতে ডেল্টা এনকোড করা এন্ট্রির সংখ্যা। যদি শুধুমাত্র একটি পূর্ণসংখ্যা এনকোড করা থাকে, তাহলে এটি শূন্য হবে এবং একক মানটি firstValue তে সংরক্ষণ করা হবে।

encodedData

string ( bytes format)

গোলম্ব-রাইস কোডার ব্যবহার করে এনকোড করা এনকোডেড ডেল্টা।

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

রাইসডেল্টাএনকোডেড২৫৬বিট

RiceDeltaEncoded32Bit এর মতোই, তবে এটি 256-বিট সংখ্যা এনকোড করে।

JSON উপস্থাপনা 
{
  "firstValueFirstPart": string,
  "firstValueSecondPart": string,
  "firstValueThirdPart": string,
  "firstValueFourthPart": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
ক্ষেত্র
firstValueFirstPart

string

এনকোডেড ডেটাতে প্রথম এন্ট্রির প্রথম ৬৪ বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে প্রথম ৬৪ বিট সব শূন্য হবে।

firstValueSecondPart

string ( uint64 format)

এনকোডেড ডেটাতে প্রথম এন্ট্রির ৬৫ থেকে ১২৮ তম বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে ৬৫ থেকে ১২৮ তম বিট সব শূন্য হবে।

firstValueThirdPart

string ( uint64 format)

এনকোডেড ডেটাতে প্রথম এন্ট্রির ১২৯ থেকে ১৯২তম বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে ১২৯ থেকে ১৯২তম বিট সব শূন্য হবে।

firstValueFourthPart

string ( uint64 format)

এনকোডেড ডেটাতে প্রথম এন্ট্রির শেষ ৬৪ বিট (হ্যাশ)। যদি ক্ষেত্রটি খালি থাকে, তাহলে শেষ ৬৪ বিট সব শূন্য হবে।

riceParameter

integer

গোলম্ব-রাইস প্যারামিটার। এই প্যারামিটারটি 227 এবং 254 এর মধ্যে হবে বলে নিশ্চিত করা হচ্ছে, সমেত।

entriesCount

integer

এনকোড করা ডেটাতে ডেল্টা এনকোড করা এন্ট্রির সংখ্যা। যদি শুধুমাত্র একটি পূর্ণসংখ্যা এনকোড করা থাকে, তাহলে এটি শূন্য হবে এবং একক মানটি firstValue তে সংরক্ষণ করা হবে।

encodedData

string ( bytes format)

গোলম্ব-রাইস কোডার ব্যবহার করে এনকোড করা এনকোডেড ডেল্টা।

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

হ্যাশলিস্ট মেটাডেটা

একটি নির্দিষ্ট হ্যাশ তালিকা সম্পর্কে মেটাডেটা।

JSON উপস্থাপনা 
{
  "threatTypes": [
    enum (ThreatType)
  ],
  "likelySafeTypes": [
    enum (LikelySafeType)
  ],
  "description": string,
  "hashLength": enum (HashLength)
}
ক্ষেত্র
threatTypes[]

enum ( ThreatType )

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

likelySafeTypes[]

enum ( LikelySafeType )

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

description

string

এই তালিকা সম্পর্কে মানুষের পঠনযোগ্য বর্ণনা। ইংরেজিতে লেখা।

hashLength

enum ( HashLength )

এই হ্যাশ তালিকার জন্য সমর্থিত হ্যাশ দৈর্ঘ্য। প্রতিটি হ্যাশ তালিকা ঠিক একটি দৈর্ঘ্য সমর্থন করবে। যদি একই ধরণের হুমকি বা নিরাপদ ধরণের জন্য আলাদা হ্যাশ দৈর্ঘ্য প্রবর্তন করা হয়, তবে এটি একটি পৃথক নাম এবং সংশ্লিষ্ট হ্যাশ দৈর্ঘ্যের সেট সহ একটি পৃথক তালিকা হিসাবে প্রবর্তন করা হবে।

হুমকির ধরণ

হুমকির প্রকারভেদ।

এনামস
THREAT_TYPE_UNSPECIFIED অজানা হুমকির ধরণ। যদি এটি সার্ভার দ্বারা ফেরত পাঠানো হয়, তাহলে ক্লায়েন্ট সম্পূর্ণরূপে সংযুক্ত FullHashDetail উপেক্ষা করবে।
MALWARE

ম্যালওয়্যার হুমকির ধরণ। ম্যালওয়্যার হল এমন যেকোনো সফ্টওয়্যার বা মোবাইল অ্যাপ্লিকেশন যা বিশেষভাবে একটি কম্পিউটার, মোবাইল ডিভাইস, এটি যে সফ্টওয়্যারটি চালাচ্ছে বা এর ব্যবহারকারীদের ক্ষতি করার জন্য তৈরি করা হয়েছে। ম্যালওয়্যার ক্ষতিকারক আচরণ প্রদর্শন করে যার মধ্যে ব্যবহারকারীর সম্মতি ছাড়াই সফ্টওয়্যার ইনস্টল করা এবং ভাইরাসের মতো ক্ষতিকারক সফ্টওয়্যার ইনস্টল করা অন্তর্ভুক্ত থাকতে পারে।

আরও তথ্য এখানে পাওয়া যাবে।

SOCIAL_ENGINEERING

সোশ্যাল ইঞ্জিনিয়ারিং হুমকির ধরণ। সোশ্যাল ইঞ্জিনিয়ারিং পৃষ্ঠাগুলি মিথ্যাভাবে দাবি করে যে তারা তৃতীয় পক্ষের হয়ে কাজ করছে, যার উদ্দেশ্য দর্শকদের বিভ্রান্ত করে এমন একটি কাজ করানো, যার মাধ্যমে দর্শক কেবল সেই তৃতীয় পক্ষের একজন প্রকৃত এজেন্টকে বিশ্বাস করবে। ফিশিং হল এক ধরণের সোশ্যাল ইঞ্জিনিয়ারিং যা দর্শকদের লগইন শংসাপত্রের মতো তথ্য প্রদানের নির্দিষ্ট কাজ সম্পাদন করতে প্রতারণা করে।

আরও তথ্য এখানে পাওয়া যাবে।

UNWANTED_SOFTWARE অবাঞ্ছিত সফ্টওয়্যার হুমকির ধরণ। অবাঞ্ছিত সফ্টওয়্যার হল এমন যেকোনো সফ্টওয়্যার যা গুগলের সফ্টওয়্যার নীতিমালা মেনে চলে না কিন্তু ম্যালওয়্যার নয়।
POTENTIALLY_HARMFUL_APPLICATION প্লে স্টোরের জন্য গুগল প্লে প্রোটেক্ট দ্বারা ব্যবহৃত সম্ভাব্য ক্ষতিকারক অ্যাপ্লিকেশন হুমকির ধরণ।

সম্ভাব্য নিরাপদ প্রকার

সম্ভাব্য-নিরাপদ সাইটের প্রকারভেদ।

মনে রাখবেন যে SearchHashesResponse ইচ্ছাকৃতভাবে LikelySafeType ধারণ করে না।

এনামস
LIKELY_SAFE_TYPE_UNSPECIFIED অজানা।
GENERAL_BROWSING এই সাইটটি সম্ভবত সাধারণ ব্রাউজিংয়ের জন্য যথেষ্ট নিরাপদ। এটি গ্লোবাল ক্যাশে নামেও পরিচিত।
CSD এই সাইটটি সম্ভবত যথেষ্ট নিরাপদ যে ক্লায়েন্ট-সাইড ডিটেকশন মডেল বা পাসওয়ার্ড সুরক্ষা পরীক্ষা চালানোর প্রয়োজন নেই।
DOWNLOAD এই সাইটটি সম্ভবত যথেষ্ট নিরাপদ যে সাইট থেকে ডাউনলোডগুলি পরীক্ষা করার প্রয়োজন নেই।

হ্যাশলেংথ

একটি হ্যাশ তালিকার হ্যাশের দৈর্ঘ্য।

এনামস
HASH_LENGTH_UNSPECIFIED অনির্দিষ্ট দৈর্ঘ্য।
FOUR_BYTES প্রতিটি হ্যাশ একটি চার-বাইট উপসর্গ।
EIGHT_BYTES প্রতিটি হ্যাশ একটি আট-বাইট উপসর্গ।
SIXTEEN_BYTES প্রতিটি হ্যাশ একটি ষোল-বাইট উপসর্গ।
THIRTY_TWO_BYTES প্রতিটি হ্যাশ একটি বত্রিশ বাইট পূর্ণ হ্যাশ।

পদ্ধতি

get

 একটি হ্যাশ তালিকার সর্বশেষ বিষয়বস্তু পায়।