Method: threatListUpdates.fetch

সবচেয়ে সাম্প্রতিক হুমকি তালিকা আপডেট আনে. একজন ক্লায়েন্ট একসাথে একাধিক তালিকার জন্য আপডেটের অনুরোধ করতে পারে।

HTTP অনুরোধ

POST https://safebrowsing.googleapis.com/v4/threatListUpdates:fetch

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

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "client": {
    object (ClientInfo)
  },
  "listUpdateRequests": [
    {
      object (ListUpdateRequest)
    }
  ]
}
ক্ষেত্র
client

object ( ClientInfo )

ক্লায়েন্ট মেটাডেটা।

listUpdateRequests[]

object ( ListUpdateRequest )

অনুরোধ করা হুমকি তালিকা আপডেট.

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

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

JSON প্রতিনিধিত্ব
{
  "listUpdateResponses": [
    {
      object (ListUpdateResponse)
    }
  ],
  "minimumWaitDuration": string
}
ক্ষেত্র
listUpdateResponses[]

object ( ListUpdateResponse )

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

minimumWaitDuration

string ( Duration format)

ক্লায়েন্টকে যেকোনো আপডেটের অনুরোধ জারি করার আগে ন্যূনতম সময়কাল অপেক্ষা করতে হবে। এই ক্ষেত্রটি সেট করা না থাকলে ক্লায়েন্টরা যত তাড়াতাড়ি চান আপডেট করতে পারে।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"

লিস্টআপডেট রিকোয়েস্ট

একটি একক তালিকা আপডেট অনুরোধ.

JSON প্রতিনিধিত্ব
{
  "threatType": enum (ThreatType),
  "platformType": enum (PlatformType),
  "threatEntryType": enum (ThreatEntryType),
  "state": string,
  "constraints": {
    object (Constraints)
  }
}
ক্ষেত্র
threatType

enum ( ThreatType )

তালিকায় উপস্থিত এন্ট্রিগুলির দ্বারা হুমকির ধরন।

platformType

enum ( PlatformType )

তালিকায় উপস্থিত এন্ট্রি দ্বারা ঝুঁকিপূর্ণ প্ল্যাটফর্মের ধরন।

threatEntryType

enum ( ThreatEntryType )

তালিকায় উপস্থিত এন্ট্রির ধরন।

state

string ( bytes format)

অনুরোধ করা তালিকার জন্য ক্লায়েন্টের বর্তমান অবস্থা (এনক্রিপ্ট করা ক্লায়েন্টের অবস্থা যা শেষ সফল তালিকা আপডেট থেকে প্রাপ্ত হয়েছিল)।

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

constraints

object ( Constraints )

এই অনুরোধের সাথে যুক্ত সীমাবদ্ধতা.

সীমাবদ্ধতা

এই আপডেটের জন্য সীমাবদ্ধতা.

JSON প্রতিনিধিত্ব
{
  "maxUpdateEntries": integer,
  "maxDatabaseEntries": integer,
  "region": string,
  "supportedCompressions": [
    enum (CompressionType)
  ],
  "language": string,
  "deviceLocation": string
}
ক্ষেত্র
maxUpdateEntries

integer

এন্ট্রি সংখ্যা সর্বোচ্চ আকার. আপডেটে এই মানের চেয়ে বেশি এন্ট্রি থাকবে না। এটি 2**10 এবং 2**20 এর মধ্যে 2 এর শক্তি হওয়া উচিত। শূন্য হলে, কোনো আপডেট আকারের সীমা সেট করা নেই।

maxDatabaseEntries

integer

নির্দিষ্ট তালিকার জন্য স্থানীয় ডাটাবেসে ক্লায়েন্ট যে সর্বোচ্চ সংখ্যক এন্ট্রি রাখতে ইচ্ছুক তা সেট করে। এটি 2**10 এবং 2**20 এর মধ্যে 2 এর শক্তি হওয়া উচিত। যদি শূন্য হয়, কোন ডাটাবেসের আকার সীমা সেট করা হয় না।

region

string

একটি নির্দিষ্ট ভৌগলিক অবস্থানের জন্য তালিকার অনুরোধ করে। যদি সেট না করা হয় সার্ভার ব্যবহারকারীর আইপি ঠিকানার উপর ভিত্তি করে সেই মানটি বেছে নিতে পারে। ISO 3166-1 আলফা-2 ফর্ম্যাট আশা করে৷

supportedCompressions[]

enum ( CompressionType )

ক্লায়েন্ট দ্বারা সমর্থিত কম্প্রেশন প্রকার।

language

string

একটি নির্দিষ্ট ভাষার জন্য তালিকার অনুরোধ করে। ISO 639 alpha-2 বিন্যাস প্রত্যাশা করে।

deviceLocation

string

একটি ক্লায়েন্টের শারীরিক অবস্থান, একটি ISO 31166-1 আলফা-2 অঞ্চল কোড হিসাবে প্রকাশ করা হয়৷

কম্প্রেশন টাইপ

যে উপায়ে হুমকি এন্ট্রি সেট সংকুচিত করা যেতে পারে।

Enums
COMPRESSION_TYPE_UNSPECIFIED অজানা।
RAW কাঁচা, সংকুচিত ডেটা।
RICE রাইস-গোলম্ব এনকোডেড ডেটা।

ListUpdateResponse

একটি পৃথক তালিকার একটি আপডেট.

JSON প্রতিনিধিত্ব
{
  "threatType": enum (ThreatType),
  "threatEntryType": enum (ThreatEntryType),
  "platformType": enum (PlatformType),
  "responseType": enum (ResponseType),
  "additions": [
    {
      object (ThreatEntrySet)
    }
  ],
  "removals": [
    {
      object (ThreatEntrySet)
    }
  ],
  "newClientState": string,
  "checksum": {
    object (Checksum)
  }
}
ক্ষেত্র
threatType

enum ( ThreatType )

হুমকি প্রকার যার জন্য ডেটা ফেরত দেওয়া হয়৷

threatEntryType

enum ( ThreatEntryType )

হুমকির বিন্যাস।

platformType

enum ( PlatformType )

প্ল্যাটফর্মের ধরন যার জন্য ডেটা ফেরত দেওয়া হয়।

responseType

enum ( ResponseType )

প্রতিক্রিয়ার ধরন। এটি নির্দেশ করতে পারে যে প্রতিক্রিয়া প্রাপ্ত হলে ক্লায়েন্টের দ্বারা একটি পদক্ষেপের প্রয়োজন।

additions[]

object ( ThreatEntrySet )

স্থানীয় হুমকি প্রকারের তালিকায় যোগ করার জন্য এন্ট্রিগুলির একটি সেট। একটি একক প্রতিক্রিয়ায় পাঠানোর জন্য সংকুচিত এবং কাঁচা ডেটার সংমিশ্রণের অনুমতি দেওয়ার জন্য পুনরাবৃত্তি করা হয়।

removals[]

object ( ThreatEntrySet )

স্থানীয় হুমকি প্রকারের তালিকা থেকে সরানোর জন্য এন্ট্রিগুলির একটি সেট৷ অনুশীলনে, এই ক্ষেত্রটি খালি বা ঠিক একটি ThreatEntrySet রয়েছে।

newClientState

string ( bytes format)

নতুন ক্লায়েন্ট অবস্থা, এনক্রিপ্ট করা বিন্যাসে। ক্লায়েন্টদের কাছে অস্বচ্ছ।

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

checksum

object ( Checksum )

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

রেসপন্স টাইপ

ক্লায়েন্টকে পাঠানো প্রতিক্রিয়ার ধরন।

Enums
RESPONSE_TYPE_UNSPECIFIED অজানা।
PARTIAL_UPDATE আংশিক আপডেট ক্লায়েন্টের বিদ্যমান স্থানীয় ডাটাবেসে প্রয়োগ করা হয়।
FULL_UPDATE সম্পূর্ণ আপডেট ক্লায়েন্টের সমগ্র স্থানীয় ডাটাবেস প্রতিস্থাপন করে। এর মানে হল ক্লায়েন্ট গুরুতরভাবে পুরানো ছিল বা ক্লায়েন্টকে দুর্নীতিগ্রস্ত বলে মনে করা হয়।

ThreatEntrySet

ক্লায়েন্টের স্থানীয় ডাটাবেস থেকে যোগ করা বা অপসারণ করা উচিত এমন হুমকির একটি সেট।

JSON প্রতিনিধিত্ব
{
  "compressionType": enum (CompressionType),
  "rawHashes": {
    object (RawHashes)
  },
  "rawIndices": {
    object (RawIndices)
  },
  "riceHashes": {
    object (RiceDeltaEncoding)
  },
  "riceIndices": {
    object (RiceDeltaEncoding)
  }
}
ক্ষেত্র
compressionType

enum ( CompressionType )

এই সেটের এন্ট্রিগুলির জন্য কম্প্রেশন প্রকার।

rawHashes

object ( RawHashes )

কাঁচা SHA256-ফরম্যাট করা এন্ট্রি।

rawIndices

object ( RawIndices )

স্থানীয় তালিকার জন্য কাঁচা অপসারণের সূচক।

riceHashes

object ( RiceDeltaEncoding )

একটি Golomb-Rice এনকোডিং ব্যবহার করে SHA256-ফরম্যাট করা এন্ট্রিগুলির এনকোড করা 4-বাইট উপসর্গ। হ্যাশগুলিকে uint32-এ রূপান্তরিত করা হয়, আরোহী ক্রমে সাজানো হয়, তারপর ডেল্টা এনকোড করা হয় এবং এনকোডেড ডেটা হিসাবে সংরক্ষণ করা হয়।

riceIndices

object ( RiceDeltaEncoding )

গোলোম্ব-রাইস এনকোডিং ব্যবহার করে এনকোড করা স্থানীয়, আভিধানিকভাবে সাজানো তালিকা সূচক। সংকুচিত অপসারণ সূচক পাঠানোর জন্য ব্যবহৃত হয়। অপসারণ সূচকগুলি (uint32) ক্রমবর্ধমান ক্রমে সাজানো হয়, তারপর ডেল্টা এনকোড করা হয় এবং এনকোডেড ডেটা হিসাবে সংরক্ষণ করা হয়।

RawHashes

একটি নির্দিষ্ট প্রিফিক্স দৈর্ঘ্যের হ্যাশ বিন্যাসে অসঙ্কুচিত হুমকি এন্ট্রি। হ্যাশগুলি 4 থেকে 32 বাইট আকারের যে কোনও জায়গায় হতে পারে। একটি বড় সংখ্যা 4 বাইট, কিন্তু কিছু হ্যাশ লম্বা করা হয় যদি সেগুলি একটি জনপ্রিয় URL এর হ্যাশের সাথে সংঘর্ষ হয়।

কম্প্রেশন সমর্থন করে না এমন ক্লায়েন্টদের ThreatEntrySet পাঠানোর জন্য বা কম্প্রেশন সমর্থন করে এমন ক্লায়েন্টদের নন-4-বাইট হ্যাশ পাঠানোর জন্য ব্যবহৃত হয়।

JSON প্রতিনিধিত্ব
{
  "prefixSize": integer,
  "rawHashes": string
}
ক্ষেত্র
prefixSize

integer

নিচে এনকোড করা প্রতিটি উপসর্গের জন্য বাইটের সংখ্যা। এই ক্ষেত্রটি 4 (সংক্ষিপ্ততম উপসর্গ) থেকে 32 (সম্পূর্ণ SHA256 হ্যাশ) থেকে যেকোনো জায়গায় হতে পারে।

rawHashes

string ( bytes format)

হ্যাশগুলি, বাইনারি বিন্যাসে, একটি দীর্ঘ স্ট্রিংয়ে সংযুক্ত। হ্যাশগুলি লেক্সিকোগ্রাফিক ক্রমে সাজানো হয়। JSON API ব্যবহারকারীদের জন্য, হ্যাশগুলি base64-এনকোডেড।

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

কাঁচা সূচক

একটি স্থানীয় তালিকা থেকে সরানোর জন্য কাঁচা সূচকগুলির একটি সেট৷

JSON প্রতিনিধিত্ব
{
  "indices": [
    integer
  ]
}
ক্ষেত্র
indices[]

integer

একটি আভিধানিকভাবে সাজানো স্থানীয় তালিকা থেকে সরানোর জন্য সূচকগুলি৷

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

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

JSON প্রতিনিধিত্ব
{
  "firstValue": string,
  "riceParameter": integer,
  "numEntries": integer,
  "encodedData": string
}
ক্ষেত্র
firstValue

string ( int64 format)

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

riceParameter

integer

Golomb-Rice প্যারামিটার, যা 2 এবং 28 এর মধ্যে একটি সংখ্যা। যদি numEntries শূন্য হয় তাহলে এই ক্ষেত্রটি অনুপস্থিত (অর্থাৎ শূন্য)।

numEntries

integer

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

encodedData

string ( bytes format)

Golomb-Rice কোডার ব্যবহার করে এনকোড করা ডেল্টা।

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

চেকসাম

ক্লায়েন্টের স্থানীয় ডাটাবেসের প্রত্যাশিত অবস্থা।

JSON প্রতিনিধিত্ব
{
  "sha256": string
}
ক্ষেত্র
sha256

string ( bytes format)

ক্লায়েন্ট স্টেটের SHA256 হ্যাশ; অর্থাৎ, ডাটাবেসে উপস্থিত সমস্ত হ্যাশের সাজানো তালিকা।

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