কাস্টম অডিয়েন্স ম্যানেজার
public class CustomAudienceManager
extends Object
| java.lang.অবজেক্ট | |
| ↳ | android.adservices.customaudience.CustomAudienceManager |
CustomAudienceManager অ্যাপ এবং বিজ্ঞাপন-SDK-এর জন্য কাস্টম শ্রোতাদের সাথে যোগ দিতে/ত্যাগ করার জন্য API প্রদান করে।
সারাংশ
পাবলিক পদ্ধতি | |
|---|---|
void | fetchAndJoinCustomAudience ( FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver) একটি |
static CustomAudienceManager | get ( Context context)CustomAudienceManager-এর একটি উদাহরণ তৈরি করার জন্য কারখানা পদ্ধতি। |
TestCustomAudienceManager | getTestCustomAudienceManager ()পরীক্ষা-সক্ষম APIs সহ একটি পরিষেবা তৈরি করুন৷ |
void | joinCustomAudience ( JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver) প্রদত্ত |
void | leaveCustomAudience ( LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver) |
উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতি | |
|---|---|
পাবলিক পদ্ধতি
fetchAndJoinCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
একটি fetchUri থেকে আনা CustomAudience এ ব্যবহারকারীকে যোগ করে।
ownerPackageName , buyer এবং name একই সংমিশ্রণে একটি কাস্টম দর্শকের জন্য ব্যবহারকারীকে নিবন্ধন করার প্রচেষ্টার ফলে বিজ্ঞাপন ডেটার তালিকা সহ বিদ্যমান কাস্টম দর্শকদের তথ্য ওভাররাইট করা হবে৷
নোট করুন যে বিজ্ঞাপন তালিকাটি দৈনিক ব্যাকগ্রাউন্ড আনার কাজ দ্বারা সম্পূর্ণরূপে ওভাররাইট করা যেতে পারে।
এই কল একটি SecurityException সঙ্গে ব্যর্থ হয় যদি
-
ownerPackageNameঅ্যাপের প্যাকেজের নাম এবং/অথবা কল করছে না - ক্রেতা API ব্যবহার করার জন্য অনুমোদিত নয়।
এই কল একটি IllegalArgumentException এর সাথে ব্যর্থ হয় যদি
- কলিং অ্যাপ্লিকেশন এবং/অথবা স্টোরেজ সীমা অতিক্রম করেছে
- প্রদত্ত
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 হতে পারে না। |
পেতে
public static CustomAudienceManager get (Context context)
CustomAudienceManager-এর একটি উদাহরণ তৈরি করার জন্য কারখানা পদ্ধতি।
| পরামিতি | |
|---|---|
context | Context : এই মানটি ব্যবহার করার Context null হতে পারে না। |
| রিটার্নস | |
|---|---|
CustomAudienceManager | একটি CustomAudienceManager উদাহরণ এই মানটি null হতে পারে না। |
GetTestCustomAudienceManager
public TestCustomAudienceManager getTestCustomAudienceManager ()
পরীক্ষা-সক্ষম APIs সহ একটি পরিষেবা তৈরি করুন৷
| রিটার্নস | |
|---|---|
TestCustomAudienceManager | এই মানটি null হতে পারে না। |
কাস্টম অডিয়েন্সে যোগ দিন
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
প্রদত্ত CustomAudience এ ব্যবহারকারীকে যোগ করে।
ownerPackageName , buyer এবং name একই সংমিশ্রণে একটি কাস্টম দর্শকের জন্য ব্যবহারকারীকে নিবন্ধন করার প্রচেষ্টার ফলে বিজ্ঞাপন ডেটার তালিকা সহ বিদ্যমান কাস্টম দর্শকদের তথ্য ওভাররাইট করা হবে৷
নোট করুন যে বিজ্ঞাপন তালিকাটি দৈনিক ব্যাকগ্রাউন্ড আনার কাজ দ্বারা সম্পূর্ণরূপে ওভাররাইট করা যেতে পারে।
এই কল একটি SecurityException সঙ্গে ব্যর্থ হয় যদি
-
ownerPackageNameঅ্যাপের প্যাকেজের নাম এবং/অথবা কল করছে না - ক্রেতা API ব্যবহার করার জন্য অনুমোদিত নয়।
এই কল একটি IllegalArgumentException এর সাথে ব্যর্থ হয় যদি
- কলিং অ্যাপ্লিকেশন এবং/অথবা স্টোরেজ সীমা অতিক্রম করেছে
- প্রদত্ত
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 হতে পারে না। |
কাস্টম অডিয়েন্স ছেড়ে দিন
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
ownerPackageName , buyer , এবং name দ্বারা চিহ্নিত যেকোনও বিদ্যমান CustomAudience ডেটা মুছে দিয়ে একটি কাস্টম দর্শকদের থেকে একজন ব্যবহারকারীকে সরানোর প্রয়াস৷
এই কল একটি SecurityException সঙ্গে ব্যর্থ হয় যদি
-
ownerPackageNameঅ্যাপের প্যাকেজ নামকে কল করছে না; এবং/অথবা - ক্রেতা API ব্যবহার করার জন্য অনুমোদিত নয়।
এই কল LimitExceededException এর সাথে ব্যর্থ হয় যদি কলিং প্যাকেজ অনুমোদিত হারের সীমা অতিক্রম করে এবং থ্রোটল করা হয়।
এই কল কলকারীকে অবহিত করে না যে নির্দিষ্ট কাস্টম অডিয়েন্স অন-ডিভাইস স্টোরেজে বিদ্যমান ছিল কিনা। অন্য কথায়, এটি নিঃশব্দে ব্যর্থ হবে যখন একজন ক্রেতা যোগদান করা হয়নি এমন একটি কাস্টম শ্রোতা ছেড়ে যাওয়ার চেষ্টা করে।
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE প্রয়োজন।ACCESS_ADSERVICES_CUSTOM_AUDIENCE
| পরামিতি | |
|---|---|
leaveCustomAudienceRequest | LeaveCustomAudienceRequest : এই মানটি null হতে পারে না। |
executor | Executor : এই মানটি null হতে পারে না। কলব্যাক এবং শ্রোতা ইভেন্টগুলি এই Executor মাধ্যমে প্রেরণ করা হয়, কোন থ্রেড ব্যবহার করা হয় তা নিয়ন্ত্রণ করার একটি সহজ উপায় প্রদান করে। আপনার অ্যাপ্লিকেশনের মূল থ্রেডের মাধ্যমে ইভেন্টগুলি প্রেরণ করতে, আপনি Context.getMainExecutor() ব্যবহার করতে পারেন। অন্যথায়, একটি Executor প্রদান করুন যা একটি উপযুক্ত থ্রেডে প্রেরণ করে। |
receiver | OutcomeReceiver : এই মানটি null হতে পারে না। |