این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

در سطح 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 حذف می‌کند.

روش های ارثی

از کلاس 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 ()` باعث می شود تا رشته فعلی منتظر بماند تا بیدار شود، معمولاً با اطلاع یا قطع شدن .

روش های عمومی

overrideAdSelectionConfigRemoteInfo

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

public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> 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

در Android UpsideDownCakePrivacySandbox اضافه شد

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

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

پارامترها
`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<Object, Exception> receiver)

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

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

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

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

در Android UpsideDownCakePrivacySandbox اضافه شد

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

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

پارامترها
`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<Object, Exception> receiver)

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

پارامترها

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

executor

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

receiver

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

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

ResetAllAdSelectionFromOutcomesConfigRemoteOverrides

در Android UpsideDownCakePrivacySandbox اضافه شد

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

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

پارامترها

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

executor

receiver

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

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