در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

TestAdSelectionManager

public class TestAdSelectionManager
extends Object

java.lang.object
android.adservices.adselection.TestAdSelectionManager


TestAdSelectionManager API هایی را برای برنامه ها و SDK های تبلیغاتی برای آزمایش فرآیندهای انتخاب آگهی ارائه می دهد.

این APIها برای آزمایش سرتاسر استفاده می شوند. آن‌ها فقط برای برنامه‌های قابل اشکال‌زدایی در تلفن‌هایی که یک سیستم‌عامل قابل اشکال زدایی با گزینه‌های توسعه‌دهنده فعال دارند، فعال هستند.

خلاصه

روش های عمومی

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

API AdSelection را برای AdSelectionConfig معین لغو می کند تا از واکشی داده ها از سرورهای راه دور جلوگیری کند و به جای آن از داده های ارائه شده در AddAdSelectionOverrideRequest استفاده کند.

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

API AdSelection را برای AdSelectionFromOutcomesConfig لغو می کند تا از واکشی داده ها از سرورهای راه دور جلوگیری کند و به جای آن از داده های ارائه شده در AddAdSelectionFromOutcomesOverrideRequest استفاده کند.

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

یک نادیده گرفتن AdSelectionConfig را در API انتخاب آگهی با داده های مرتبط در RemoveAdSelectionOverrideRequest حذف می کند.

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

یک نادیده گرفتن AdSelectionFromOutcomesConfig را در API انتخاب آگهی با داده های مرتبط در RemoveAdSelectionOverrideRequest حذف می کند.

void resetAllAdSelectionConfigRemoteOverrides ( Executor executor, OutcomeReceiver < Object , Exception > receiver)

تمام داده‌های لغو AdSelectionConfig را در Ad Selection API حذف می‌کند.

void resetAllAdSelectionFromOutcomesConfigRemoteOverrides ( Executor executor, OutcomeReceiver < Object , Exception > receiver)

تمام داده‌های نادیده گرفته شده برای AdSelectionFromOutcomesConfig را در Ad Selection API حذف می‌کند.

روش های ارثی

روش های عمومی

overrideAdSelectionConfigRemoteInfo

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

API AdSelection را برای AdSelectionConfig معین لغو می کند تا از واکشی داده ها از سرورهای راه دور جلوگیری کند و به جای آن از داده های ارائه شده در AddAdSelectionOverrideRequest استفاده کند. AddAdSelectionOverrideRequest توسط Ads SDK ارائه شده است.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
request AddAdSelectionOverrideRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.

overrideAdSelectionFromOutcomesConfigRemoteInfo

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

API AdSelection را برای AdSelectionFromOutcomesConfig لغو می کند تا از واکشی داده ها از سرورهای راه دور جلوگیری کند و به جای آن از داده های ارائه شده در AddAdSelectionFromOutcomesOverrideRequest استفاده کند. AddAdSelectionFromOutcomesOverrideRequest توسط Ads SDK ارائه شده است.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
request AddAdSelectionFromOutcomesOverrideRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.

removeAdSelectionConfigRemoteInfoOverride

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4
public void removeAdSelectionConfigRemoteInfoOverride (RemoveAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

یک نادیده گرفتن AdSelectionConfig را در API انتخاب آگهی با داده های مرتبط در RemoveAdSelectionOverrideRequest حذف می کند. RemoveAdSelectionOverrideRequest توسط Ads SDK ارائه شده است.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
request RemoveAdSelectionOverrideRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

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

یک نادیده گرفتن AdSelectionFromOutcomesConfig را در API انتخاب آگهی با داده های مرتبط در RemoveAdSelectionOverrideRequest حذف می کند. RemoveAdSelectionOverrideRequest توسط Ads SDK ارائه شده است.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
request RemoveAdSelectionFromOutcomesOverrideRequest : این مقدار نمی تواند null باشد.

executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.

ResetAllAdSelectionConfigRemoteOverrides

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public void resetAllAdSelectionConfigRemoteOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

تمام داده‌های لغو AdSelectionConfig را در Ad Selection API حذف می‌کند.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.

ResetAllAdSelectionFromOutcomesConfigRemoteOverrides

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

تمام داده‌های نادیده گرفته شده برای AdSelectionFromOutcomesConfig را در Ad Selection API حذف می‌کند.

این روش برای آزمایش انتها به انتها در نظر گرفته شده است. این API فقط برای برنامه‌هایی که در حالت اشکال‌زدایی هستند و گزینه‌های توسعه‌دهنده فعال هستند، فعال است.
به AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE نیاز دارد.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

پارامترها
executor Executor : این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

receiver OutcomeReceiver : این مقدار نمی تواند null باشد.

پرتاب می کند
IllegalStateException اگر این API برای تماس گیرنده فعال نباشد

گیرنده یا یک void برای اجرای موفقیت آمیز برمی گرداند، یا یک Exception نشان دهنده خطا است.