কাস্টম অডিয়েন্স ম্যানেজার

public class CustomAudienceManager
extends Object

java.lang.অবজেক্ট
android.adservices.customaudience.CustomAudienceManager


CustomAudienceManager অ্যাপ এবং বিজ্ঞাপন-SDK-এর জন্য কাস্টম শ্রোতাদের সাথে যোগ দিতে/ত্যাগ করার জন্য API প্রদান করে।

সারাংশ

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

void fetchAndJoinCustomAudience ( FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

একটি fetchUri থেকে আনা CustomAudience এ ব্যবহারকারীকে যোগ করে।

static CustomAudienceManager get ( Context context)

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

TestCustomAudienceManager getTestCustomAudienceManager ()

পরীক্ষা-সক্ষম APIs সহ একটি পরিষেবা তৈরি করুন৷

void joinCustomAudience ( JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

প্রদত্ত CustomAudience এ ব্যবহারকারীকে যোগ করে।

void leaveCustomAudience ( LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

ownerPackageName , buyer , এবং name দ্বারা চিহ্নিত যেকোনও বিদ্যমান CustomAudience ডেটা মুছে দিয়ে একটি কাস্টম দর্শকদের থেকে একজন ব্যবহারকারীকে সরানোর প্রয়াস৷

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

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

fetchAndJoinCustomAudience

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

একটি fetchUri থেকে আনা CustomAudience এ ব্যবহারকারীকে যোগ করে।

ownerPackageName , buyer এবং name একই সংমিশ্রণে একটি কাস্টম দর্শকের জন্য ব্যবহারকারীকে নিবন্ধন করার প্রচেষ্টার ফলে বিজ্ঞাপন ডেটার তালিকা সহ বিদ্যমান কাস্টম দর্শকদের তথ্য ওভাররাইট করা হবে৷

নোট করুন যে বিজ্ঞাপন তালিকাটি দৈনিক ব্যাকগ্রাউন্ড আনার কাজ দ্বারা সম্পূর্ণরূপে ওভাররাইট করা যেতে পারে।

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

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

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

  1. কলিং অ্যাপ্লিকেশন এবং/অথবা স্টোরেজ সীমা অতিক্রম করেছে
  2. প্রদত্ত CustomAudience এর কোনো URI পরামিতি CustomAudience ক্রেতার কাছে প্রমাণীকৃত নয়।

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

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

পরামিতি
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest : এই মানটি null হতে পারে না।

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

receiver OutcomeReceiver : এই মানটি null হতে পারে না।

পেতে

API স্তর 34 এ যোগ করা হয়েছে
এছাড়াও বিজ্ঞাপন পরিষেবা এক্সটেনশন 6
public static CustomAudienceManager get (Context context)

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

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

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

GetTestCustomAudienceManager

API স্তর 34 এ যোগ করা হয়েছে
এছাড়াও বিজ্ঞাপন পরিষেবা এক্সটেনশন 4
public TestCustomAudienceManager getTestCustomAudienceManager ()

পরীক্ষা-সক্ষম APIs সহ একটি পরিষেবা তৈরি করুন৷

রিটার্নস
TestCustomAudienceManager এই মানটি null হতে পারে না।

কাস্টম অডিয়েন্সে যোগ দিন

API স্তর 34 এ যোগ করা হয়েছে
এছাড়াও বিজ্ঞাপন পরিষেবা এক্সটেনশন 4
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

প্রদত্ত CustomAudience এ ব্যবহারকারীকে যোগ করে।

ownerPackageName , buyer এবং name একই সংমিশ্রণে একটি কাস্টম দর্শকের জন্য ব্যবহারকারীকে নিবন্ধন করার প্রচেষ্টার ফলে বিজ্ঞাপন ডেটার তালিকা সহ বিদ্যমান কাস্টম দর্শকদের তথ্য ওভাররাইট করা হবে৷

নোট করুন যে বিজ্ঞাপন তালিকাটি দৈনিক ব্যাকগ্রাউন্ড আনার কাজ দ্বারা সম্পূর্ণরূপে ওভাররাইট করা যেতে পারে।

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

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

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

  1. কলিং অ্যাপ্লিকেশন এবং/অথবা স্টোরেজ সীমা অতিক্রম করেছে
  2. প্রদত্ত CustomAudience এর কোনো URI পরামিতি CustomAudience ক্রেতার কাছে প্রমাণীকৃত নয়।

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

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

পরামিতি
joinCustomAudienceRequest JoinCustomAudienceRequest : এই মানটি null হতে পারে না।

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

receiver OutcomeReceiver : এই মানটি null হতে পারে না।

কাস্টম অডিয়েন্স ছেড়ে দিন

API স্তর 34 এ যোগ করা হয়েছে
এছাড়াও বিজ্ঞাপন পরিষেবা এক্সটেনশন 4
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

ownerPackageName , buyer , এবং name দ্বারা চিহ্নিত যেকোনও বিদ্যমান CustomAudience ডেটা মুছে দিয়ে একটি কাস্টম দর্শকদের থেকে একজন ব্যবহারকারীকে সরানোর প্রয়াস৷

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

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

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

এই কল কলকারীকে অবহিত করে না যে নির্দিষ্ট কাস্টম অডিয়েন্স অন-ডিভাইস স্টোরেজে বিদ্যমান ছিল কিনা। অন্য কথায়, এটি নিঃশব্দে ব্যর্থ হবে যখন একজন ক্রেতা যোগদান করা হয়নি এমন একটি কাস্টম শ্রোতা ছেড়ে যাওয়ার চেষ্টা করে।
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE প্রয়োজন।ACCESS_ADSERVICES_CUSTOM_AUDIENCE

পরামিতি
leaveCustomAudienceRequest LeaveCustomAudienceRequest : এই মানটি null হতে পারে না।

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

receiver OutcomeReceiver : এই মানটি null হতে পারে না।