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

TestAdSelectionManager

public class TestAdSelectionManager
extends Object

java.lang.Object
   ↳ android.adservices.adselection.TestAdSelectionManager


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

इन एपीआई का इस्तेमाल, शुरू से आखिर तक की जाने वाली जांच के लिए किया जाता है. ये सिर्फ़ डीबग किए जा सकने वाले ऐप्लिकेशन के लिए चालू होते हैं. ये ऐप्लिकेशन, डीबग किए जा सकने वाले ओएस बिल्ड वाले फ़ोन पर चलते हैं. साथ ही, इनमें डेवलपर के लिए सेटिंग और टूल चालू होने चाहिए.

खास जानकारी

सार्वजनिक तरीके

void overrideAdSelectionConfigRemoteInfo(AddAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

किसी दिए गए AdSelectionConfig के लिए AdSelection API को बदल देता है, ताकि रिमोट सर्वर से डेटा फ़ेच करने से बचा जा सके. इसके बजाय, AddAdSelectionOverrideRequest में दिए गए डेटा का इस्तेमाल किया जाता है.

void overrideAdSelectionFromOutcomesConfigRemoteInfo(AddAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

AdSelectionFromOutcomesConfig के लिए AdSelection API को बदल देता है, ताकि रिमोट सर्वर से डेटा फ़ेच करने से बचा जा सके. साथ ही, AddAdSelectionFromOutcomesOverrideRequest में दिए गए डेटा का इस्तेमाल किया जा सके.

void removeAdSelectionConfigRemoteInfoOverride(RemoveAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API में AdSelectionConfig के लिए, RemoveAdSelectionOverrideRequest में मौजूद डेटा के साथ बदलाव को हटाता है.

void removeAdSelectionFromOutcomesConfigRemoteInfoOverride(RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API में AdSelectionFromOutcomesConfig के लिए, RemoveAdSelectionOverrideRequest में मौजूद डेटा के साथ बदलाव को हटाता है.

void resetAllAdSelectionConfigRemoteOverrides(Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API में AdSelectionConfig के लिए, ओवरराइड किया गया सारा डेटा हटा देता है.

void resetAllAdSelectionFromOutcomesConfigRemoteOverrides(Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API में AdSelectionFromOutcomesConfig के लिए, ओवरराइड किया गया सारा डेटा हटा देता है.

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

सार्वजनिक तरीके

overrideAdSelectionConfigRemoteInfo

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया
public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

किसी दिए गए AdSelectionConfig के लिए, AdSelection API को बदल देता है, ताकि रिमोट सर्वर से डेटा फ़ेच करने से बचा जा सके. इसके बजाय, AddAdSelectionOverrideRequest में दिए गए डेटा का इस्तेमाल किया जाता है. AddAdSelectionOverrideRequest को Ads SDK टूल उपलब्ध कराता है.

इस तरीके का इस्तेमाल, शुरू से आखिर तक जांच करने के लिए किया जाता है. यह एपीआई सिर्फ़ उन ऐप्लिकेशन के लिए चालू होता है जो डिबग मोड में हैं और जिनमें डेवलपर के विकल्प चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
request AddAdSelectionOverrideRequest: यह वैल्यू null नहीं हो सकती.

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉलर के लिए यह एपीआई चालू नहीं है

रिसीवर, प्रोसेस पूरी होने पर void दिखाता है या गड़बड़ी होने पर Exception दिखाता है.

overrideAdSelectionFromOutcomesConfigRemoteInfo

public void overrideAdSelectionFromOutcomesConfigRemoteInfo (AddAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

यह नीति AdSelectionFromOutcomesConfig के लिए AdSelection API को बदल देती है, ताकि रिमोट सर्वर से डेटा फ़ेच न किया जा सके और AddAdSelectionFromOutcomesOverrideRequest में दिए गए डेटा का इस्तेमाल किया जा सके. AddAdSelectionFromOutcomesOverrideRequest को Ads SDK टूल उपलब्ध कराता है.

इस तरीके का इस्तेमाल, एंड-टू-एंड टेस्टिंग के लिए किया जाता है. यह एपीआई सिर्फ़ डीबग मोड वाले उन ऐप्लिकेशन के लिए चालू है जिनमें डेवलपर के लिए सेटिंग और टूल चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
request AddAdSelectionFromOutcomesOverrideRequest: यह वैल्यू null नहीं हो सकती.

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉल करने वाले के लिए यह एपीआई चालू नहीं है

रिसीवर, प्रोसेस पूरी होने पर void दिखाता है या गड़बड़ी होने पर Exception दिखाता है.

removeAdSelectionConfigRemoteInfoOverride

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया
public void removeAdSelectionConfigRemoteInfoOverride (RemoveAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

विज्ञापन चुनने के एपीआई में, RemoveAdSelectionOverrideRequest में मौजूद डेटा से जुड़े AdSelectionConfig के लिए ओवरराइड हटा देता है. RemoveAdSelectionOverrideRequest को Ads SDK टूल उपलब्ध कराता है.

इस तरीके का इस्तेमाल, शुरू से आखिर तक जांच करने के लिए किया जाता है. यह एपीआई सिर्फ़ उन ऐप्लिकेशन के लिए चालू होता है जो डिबग मोड में हैं और जिनमें डेवलपर के विकल्प चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
request RemoveAdSelectionOverrideRequest: यह वैल्यू null नहीं हो सकती.

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉलर के लिए यह एपीआई चालू नहीं है

पाने वाला, सही तरीके से चलने के लिए void दिखाता है या Exception गड़बड़ी का मैसेज दिखाता है.

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

public void removeAdSelectionFromOutcomesConfigRemoteInfoOverride (RemoveAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

विज्ञापन चुनने के एपीआई में मौजूद AdSelectionFromOutcomesConfig के लिए, RemoveAdSelectionOverrideRequest में मौजूद डेटा से हुए बदलाव को हटाता है. RemoveAdSelectionOverrideRequest, Google Ads SDK टूल से मिलता है.

इस तरीके का इस्तेमाल, एंड-टू-एंड टेस्टिंग के लिए किया जाता है. यह एपीआई सिर्फ़ डीबग मोड वाले उन ऐप्लिकेशन के लिए चालू है जिनमें डेवलपर के लिए सेटिंग और टूल चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

पैरामीटर
request RemoveAdSelectionFromOutcomesOverrideRequest: यह वैल्यू null नहीं हो सकती.

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉल करने वाले के लिए यह एपीआई चालू नहीं है

रिसीवर, सही तरीके से चलने पर void दिखाता है या गड़बड़ी होने पर Exception दिखाता है.

resetAllAdSelectionConfigRemoteOverrides

एपीआई लेवल 34 में जोड़ा गया
Ad Services एक्सटेंशन 4 में भी जोड़ा गया
public void resetAllAdSelectionConfigRemoteOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Ad Selection API में AdSelectionConfig के लिए, बदले गए सभी डेटा को हटाता है.

इस तरीके का इस्तेमाल, एंड-टू-एंड टेस्टिंग के लिए किया जाता है. यह एपीआई सिर्फ़ उन ऐप्लिकेशन के लिए चालू होता है जो डिबग मोड में हैं और जिनमें डेवलपर के विकल्प चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉलर के लिए यह एपीआई चालू नहीं है

रिसीवर, सही तरीके से चलने पर void दिखाता है या गड़बड़ी होने पर Exception दिखाता है.

resetAllAdSelectionFromOutcomesConfigRemoteOverrides

public void resetAllAdSelectionFromOutcomesConfigRemoteOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

विज्ञापन चुनने के एपीआई में, AdSelectionFromOutcomesConfig का पूरा डेटा हटा देता है.

इस तरीके का इस्तेमाल, एंड-टू-एंड टेस्टिंग के लिए किया जाता है. यह एपीआई सिर्फ़ उन ऐप्लिकेशन के लिए चालू होता है जो डिबग मोड में हैं और जिनमें डेवलपर के विकल्प चालू हैं.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE की ज़रूरत है

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

receiver OutcomeReceiver: यह वैल्यू null नहीं हो सकती.

थ्रो
IllegalStateException अगर कॉल करने वाले के लिए यह एपीआई चालू नहीं है

पाने वाला, सही तरीके से चलने के लिए void दिखाता है या Exception गड़बड़ी का मैसेज दिखाता है.