সুরক্ষিত সিগন্যাল ম্যানেজার

public class ProtectedSignalsManager
extends Object

java.lang.অবজেক্ট
↳	android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager তাদের সুরক্ষিত সংকেত পরিচালনা করতে অ্যাপ এবং বিজ্ঞাপন-SDK-এর জন্য API প্রদান করে।

সারাংশ

পাবলিক পদ্ধতি
`static ProtectedSignalsManager`	`get ( Context context)` ProtectedSignalsManager-এর একটি উদাহরণ তৈরি করার জন্য কারখানা পদ্ধতি।
`void`	`updateSignals ( UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)` UpdateSignals API URI থেকে একটি JSON পুনরুদ্ধার করবে যা বর্ণনা করে যে কোন সিগন্যাল যোগ করতে হবে বা অপসারণ করতে হবে।

উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতি

java.lang.Object ক্লাস থেকে

`Object`	`clone ()` এই বস্তুর একটি অনুলিপি তৈরি করে এবং ফেরত দেয়।
`boolean`	`equals ( Object obj)` অন্য কোন বস্তু এটির "সমান" কিনা তা নির্দেশ করে।
`void`	`finalize ()` একটি বস্তুর উপর আবর্জনা সংগ্রাহক দ্বারা কল করা হয় যখন আবর্জনা সংগ্রহ নির্ধারণ করে যে বস্তুটির আর কোন উল্লেখ নেই।
`final Class <?>`	`getClass ()` এই `Object` রানটাইম ক্লাস রিটার্ন করে।
`int`	`hashCode ()` বস্তুর জন্য একটি হ্যাশ কোড মান প্রদান করে।
`final void`	`notify ()` একটি একক থ্রেড জাগিয়ে তোলে যা এই বস্তুর মনিটরে অপেক্ষা করছে।
`final void`	`notifyAll ()` এই বস্তুর মনিটরে অপেক্ষা করা সমস্ত থ্রেডকে জাগিয়ে তোলে।
`String`	`toString ()` বস্তুর একটি স্ট্রিং উপস্থাপনা প্রদান করে।
`final void`	`wait (long timeoutMillis, int nanos)` এটি জাগ্রত না হওয়া পর্যন্ত বর্তমান থ্রেডটিকে অপেক্ষা করতে দেয়, সাধারণত অবহিত করা বা বাধা দেওয়া , বা একটি নির্দিষ্ট পরিমাণ বাস্তব সময় অতিবাহিত না হওয়া পর্যন্ত।
`final void`	`wait (long timeoutMillis)` এটি জাগ্রত না হওয়া পর্যন্ত বর্তমান থ্রেডটিকে অপেক্ষা করতে দেয়, সাধারণত অবহিত করা বা বাধা দেওয়া , বা একটি নির্দিষ্ট পরিমাণ বাস্তব সময় অতিবাহিত না হওয়া পর্যন্ত।
`final void`	`wait ()` এটি জাগ্রত না হওয়া পর্যন্ত বর্তমান থ্রেডটিকে অপেক্ষা করতে দেয়, সাধারণত অবহিত করা বা বাধা দেওয়া হয় ৷

পাবলিক পদ্ধতি

পেতে

Android UpsideDownCakePrivacySandbox-এ যোগ করা হয়েছে

public static ProtectedSignalsManager get (Context context)

ProtectedSignalsManager-এর একটি উদাহরণ তৈরি করার জন্য কারখানা পদ্ধতি।

পরামিতি
`context`	`Context` : এই মানটি ব্যবহার করার `Context` `null` হতে পারে না।

রিটার্নস
`ProtectedSignalsManager`	একটি `ProtectedSignalsManager` উদাহরণ এই মানটি `null` হতে পারে না।

আপডেট সিগন্যাল

Android UpsideDownCakePrivacySandbox-এ যোগ করা হয়েছে

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

UpdateSignals API URI থেকে একটি JSON পুনরুদ্ধার করবে যা বর্ণনা করে যে কোন সিগন্যাল যোগ করতে হবে বা অপসারণ করতে হবে। এই API এছাড়াও এনকোডার শেষ পয়েন্ট নিবন্ধন অনুমতি দেয়. এন্ডপয়েন্টটি একটি এনকোডিং লজিক ডাউনলোড করতে ব্যবহৃত হয়, যা সিগন্যাল এনকোডিং সক্ষম করে।

JSON-এর জন্য শীর্ষ স্তরের কীগুলি অবশ্যই 5টি কমান্ডের একটির সাথে সঙ্গতিপূর্ণ হতে হবে:

"পুট" - একটি নতুন সংকেত যোগ করে, একই কী দিয়ে বিদ্যমান যেকোনো সিগন্যাল ওভাররাইট করে। এটির জন্য মান হল একটি JSON অবজেক্ট যেখানে কীগুলি হল বেস 64 স্ট্রিং যা রাখা কী-এর সাথে সম্পর্কিত এবং মানগুলি হল বেস 64 স্ট্রিং যা রাখার মানের সাথে সম্পর্কিত৷

"সংযোজন" - সিগন্যালের একটি টাইম সিরিজে একটি নতুন সংকেত/সংকেত যুক্ত করে, যদি সিরিজের আকার প্রদত্ত সর্বাধিকের চেয়ে বেশি হয় তবে নতুনগুলির জন্য জায়গা তৈরি করতে সবচেয়ে পুরানো সংকেতগুলিকে সরিয়ে দেয়৷ এটির মান হল একটি JSON অবজেক্ট যেখানে কীগুলি হল বেস 64টি স্ট্রিং যা সংযুক্ত করার কী-এর সাথে সম্পর্কিত এবং মানগুলি হল দুটি ক্ষেত্র সহ অবজেক্ট: "values" এবং "maxSignals"। "মান" হল বেস 64 স্ট্রিংগুলির একটি তালিকা যা টাইম সিরিজে যুক্ত করার জন্য সংকেত মানগুলির সাথে সম্পর্কিত। "maxSignals" হল এই টাইমসিরিজে অনুমোদিত সর্বোচ্চ সংখ্যক মান। যদি কীটির সাথে যুক্ত সংকেতের বর্তমান সংখ্যা ম্যাক্সসিগন্যালকে অতিক্রম করে তবে প্রাচীনতম সংকেতগুলি সরানো হবে। মনে রাখবেন আপনি পুট দ্বারা যোগ করা একটি কী যুক্ত করতে পারেন। এমন নয় যে সর্বাধিক সংখ্যার চেয়ে বেশি মানের যোগ করা ব্যর্থতার কারণ হবে।

"put_if_not_present" - একই কী সহ কোনো বিদ্যমান সংকেত না থাকলে শুধুমাত্র একটি নতুন সংকেত যোগ করে। এটির জন্য মান হল একটি JSON অবজেক্ট যেখানে কীগুলি হল বেস 64 স্ট্রিং যা রাখা কী-এর সাথে সম্পর্কিত এবং মানগুলি হল বেস 64 স্ট্রিং যা রাখার মানের সাথে সম্পর্কিত৷

"রিমুভ" - একটি চাবির জন্য সংকেত সরিয়ে দেয়। এর মান হল বেস 64 স্ট্রিংগুলির একটি তালিকা যা সংকেতগুলির কীগুলির সাথে সম্পর্কিত যা মুছে ফেলা উচিত।

"update_encoder" - এন্ডপয়েন্ট আপডেট করার জন্য একটি ক্রিয়া এবং একটি URI প্রদান করে যা একটি এনকোডিং লজিক পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে। একটি আপডেট অ্যাকশন প্রদানের উপ-কী হল "ক্রিয়া" এবং বর্তমানে সমর্থিত মানগুলি হল:

"রেজিস্টার" : প্রথমবার প্রদান করা হলে এনকোডার এন্ডপয়েন্ট নিবন্ধন করে অথবা নতুন প্রদত্ত এন্ডপয়েন্ট দিয়ে বিদ্যমানটিকে ওভাররাইট করে। "রেজিস্টার" অ্যাকশনের জন্য "এন্ডপয়েন্ট" প্রদান করা প্রয়োজন।

একটি এনকোডার এন্ডপয়েন্ট প্রদানের জন্য সাব-কি হল "এন্ডপয়েন্ট" এবং মান হল এন্ডপয়েন্টের জন্য URI স্ট্রিং।

কী শুধুমাত্র JSON প্রতি একটি কমান্ড দ্বারা পরিচালিত হতে পারে। যদি দুটি কমান্ড একই কীতে কাজ করার চেষ্টা করে, এই পদ্ধতিটি একটি IllegalArgumentException এর মাধ্যমে হবে

এই কল একটি SecurityException সঙ্গে ব্যর্থ হয় যদি

ownerPackageName অ্যাপের প্যাকেজের নাম এবং/অথবা কল করছে না
ক্রেতা API ব্যবহার করার জন্য অনুমোদিত নয়।

এই কল একটি IllegalArgumentException এর সাথে ব্যর্থ হয় যদি

সার্ভার থেকে পুনরুদ্ধার করা JSON বৈধ নয়।
প্রদত্ত URI অবৈধ৷

এই কল LimitExceededException এর সাথে ব্যর্থ হয় যদি কলিং প্যাকেজ অনুমোদিত হারের সীমা অতিক্রম করে এবং থ্রোটল করা হয়।

অভ্যন্তরীণ পরিষেবা ত্রুটির সম্মুখীন হলে এই কলটি একটি IllegalStateException এর সাথে ব্যর্থ হয়৷
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE প্রয়োজন।ACCESS_ADSERVICES_CUSTOM_AUDIENCE

পরামিতি
`updateSignalsRequest`	`UpdateSignalsRequest` : এই মানটি `null` হতে পারে না।
`executor`	`Executor` : এই মানটি `null` হতে পারে না। কলব্যাক এবং শ্রোতা ইভেন্টগুলি এই `Executor` মাধ্যমে প্রেরণ করা হয়, কোন থ্রেড ব্যবহার করা হয় তা নিয়ন্ত্রণ করার একটি সহজ উপায় প্রদান করে। আপনার অ্যাপ্লিকেশনের মূল থ্রেডের মাধ্যমে ইভেন্টগুলি প্রেরণ করতে, আপনি `Context.getMainExecutor()` ব্যবহার করতে পারেন। অন্যথায়, একটি `Executor` প্রদান করুন যা একটি উপযুক্ত থ্রেডে প্রেরণ করে।
`receiver`	`OutcomeReceiver` : এই মানটি `null` হতে পারে না।