कस्टम ऑडियंस मैनेजर

public class CustomAudienceManager
extends Object

java.lang.Object
↳	android.adservices.customaudience.CustomAudienceManager

कस्टम ऑडियंस मैनेजर, ऐप्लिकेशन और विज्ञापन SDK टूल के लिए एपीआई उपलब्ध कराता है, ताकि कस्टम ऑडियंस में शामिल हुआ जा सके या उन्हें छोड़ा जा सके.

खास जानकारी

सार्वजनिक तरीके
`void`	`fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` उपयोगकर्ता को `fetchUri` से फ़ेच किए गए `CustomAudience` में जोड़ता है.
`static CustomAudienceManager`	`get(Context context)` कस्टम ऑडियंस मैनेजर का इंस्टेंस बनाने का फ़ैक्ट्री तरीका.
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` जांच करने वाले एपीआई की मदद से सेवा बनाना
`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` डेटा को मिटाया जाता है.

इनहेरिट किए गए तरीके

क्लास से


        
          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 void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

उपयोगकर्ता को fetchUri से फ़ेच किए गए CustomAudience में जोड़ता है.

ownerPackageName, buyer, और name के उसी कॉम्बिनेशन के साथ उपयोगकर्ता को कस्टम ऑडियंस के लिए रजिस्टर करने की कोशिश करने पर, मौजूदा कस्टम ऑडियंस की ओवरराइट की जाने वाली जानकारी, जिसमें विज्ञापनों के डेटा की सूची शामिल है.

ध्यान दें कि विज्ञापन सूची को हर दिन के बैकग्राउंड फ़ेच के टास्क के ज़रिए, पूरी तरह से ओवरराइट किया जा सकता है.

यह कॉल SecurityException से पूरा नहीं हो पाता, अगर

ownerPackageName, ऐप्लिकेशन के पैकेज नाम को कॉल नहीं कर रहा है और/या
खरीदार, API का इस्तेमाल करने के लिए अधिकृत नहीं है.

यह कॉल IllegalArgumentException से पूरा नहीं हो पाता, अगर

कॉल करने के लिए इस्तेमाल किए जाने वाले ऐप्लिकेशन के लिए, स्टोरेज की सीमा पार हो गई है और/या
CustomAudience में दिए गए कोई भी यूआरआई पैरामीटर CustomAudience खरीदार.

अगर कॉलिंग पैकेज इससे ज़्यादा हो जाता है, तो यह कॉल LimitExceededException के साथ विफल हो जाता है की अनुमति नहीं है और इसे थ्रॉटल कर दिया गया है.

अगर अंदरूनी सेवा में कोई गड़बड़ी है, तो यह कॉल IllegalStateException का इस्तेमाल करके नहीं किया जा सकेगा मिला.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
`fetchAndJoinCustomAudienceRequest`	`FetchAndJoinCustomAudienceRequest`: यह वैल्यू `null` नहीं हो सकती.
`executor`	`Executor`: यह वैल्यू `null` नहीं हो सकती. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं `Executor` की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं `Context.getMainExecutor()`. अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला `Executor` दें.
`receiver`	`OutcomeReceiver`: यह वैल्यू `null` नहीं हो सकती.

पाएं

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 6 में भी जोड़ा गया

public static CustomAudienceManager get (Context context)

कस्टम ऑडियंस मैनेजर का इंस्टेंस बनाने का फ़ैक्ट्री तरीका.

पैरामीटर
`context`	`Context`: इस्तेमाल करने के लिए `Context` यह मान `null` नहीं हो सकता.

रिटर्न
`CustomAudienceManager`	`CustomAudienceManager` इंस्टेंस यह मान `null` नहीं हो सकता.

getTestCustomAudienceManager

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

public TestCustomAudienceManager getTestCustomAudienceManager ()

जांच करने वाले एपीआई की मदद से सेवा बनाना

रिटर्न
`TestCustomAudienceManager`	यह मान `null` नहीं हो सकता.

'कस्टम ऑडियंस' में शामिल हों

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

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

उपयोगकर्ता को दिए गए CustomAudience में जोड़ता है.

यह कॉल SecurityException से पूरा नहीं हो पाता, अगर

ownerPackageName, ऐप्लिकेशन के पैकेज नाम को कॉल नहीं कर रहा है और/या
खरीदार, API का इस्तेमाल करने के लिए अधिकृत नहीं है.

यह कॉल IllegalArgumentException से पूरा नहीं हो पाता, अगर

कॉल करने के लिए इस्तेमाल किए जाने वाले ऐप्लिकेशन के लिए, स्टोरेज की सीमा पार हो गई है और/या
CustomAudience में दिए गए कोई भी यूआरआई पैरामीटर CustomAudience खरीदार.

पैरामीटर
`joinCustomAudienceRequest`	`JoinCustomAudienceRequest`: यह वैल्यू `null` नहीं हो सकती.
`executor`	`Executor`: यह वैल्यू `null` नहीं हो सकती. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं `Executor` की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं `Context.getMainExecutor()`. अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला `Executor` दें.
`receiver`	`OutcomeReceiver`: यह वैल्यू `null` नहीं हो सकती.

कस्टम ऑडियंस छोड़ें

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

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

कस्टम ऑडियंस से किसी उपयोगकर्ता को हटाने की कोशिश करता है. ऐसा करने के लिए, ownerPackageName, buyer, और name से पहचाने गए मौजूदा CustomAudience डेटा को मिटाया जाता है.

यह कॉल SecurityException से पूरा नहीं हो पाता, अगर

ownerPackageName, ऐप्लिकेशन के पैकेज का नाम कॉल नहीं कर रहा है; और/या
खरीदार, API का इस्तेमाल करने के लिए अधिकृत नहीं है.

यह कॉल, कॉलर को यह जानकारी नहीं देता कि तय की गई कस्टम ऑडियंस मौजूद है या नहीं डिवाइस का स्टोरेज. दूसरे शब्दों में, जब कोई खरीदार किसी शामिल नहीं हुए कस्टम ऑडियंस.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
`leaveCustomAudienceRequest`	`LeaveCustomAudienceRequest`: यह वैल्यू `null` नहीं हो सकती.
`executor`	`Executor`: यह वैल्यू `null` नहीं हो सकती. कॉलबैक और लिसनर इवेंट इस तरीके से भेजे जाते हैं `Executor` की मदद से, यह आसानी से कंट्रोल किया जा सकता है कि कौनसा थ्रेड इस्तेमाल किया गया. अपने मुख्य थ्रेड के ज़रिए इवेंट भेजने के लिए तो आप उपयोग कर सकते हैं `Context.getMainExecutor()`. अगर ऐसा नहीं है, तो सही थ्रेड पर भेजने वाला `Executor` दें.
`receiver`	`OutcomeReceiver`: यह वैल्यू `null` नहीं हो सकती.