تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

مدير TestAdSelectionManager

public class TestAdSelectionManager
extends Object

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

توفِّر TestAdSelectionManager واجهات برمجة تطبيقات للتطبيقات وحِزم تطوير البرامج (SDK) لعرض الإعلانات من أجل اختبار عمليات اختيار الإعلانات.

تم تصميم واجهات برمجة التطبيقات هذه لاستخدامها في الاختبار الشامل. ولا يتم تفعيلها إلا ل التطبيقات القابلة لتصحيح الأخطاء على الهواتف التي تعمل بإصدار نظام تشغيل قابل لتصحيح الأخطاء مع تفعيل خيارات المطوّرين.

ملخّص

الطرق العامة
`void`	`overrideAdSelectionConfigRemoteInfo(AddAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` لإلغاء واجهة برمجة التطبيقات AdSelection API لـ `AdSelectionConfig` المحدَّد لتجنُّب جلب البيانات من الخوادم البعيدة، واستخدام البيانات المتوفّرة في `AddAdSelectionOverrideRequest` بدلاً من ذلك.
`void`	`overrideAdSelectionFromOutcomesConfigRemoteInfo(AddAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` لإلغاء واجهة برمجة التطبيقات AdSelection API في `AdSelectionFromOutcomesConfig` لتجنُّب استرجاع البيانات من الخوادم البعيدة واستخدام البيانات المقدَّمة في `AddAdSelectionFromOutcomesOverrideRequest` بدلاً من ذلك.
`void`	`removeAdSelectionConfigRemoteInfoOverride(RemoveAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` تزيل هذه العملية عملية إلغاء `AdSelectionConfig` في Ad Selection API مع البيانات المقترنة في `RemoveAdSelectionOverrideRequest`.
`void`	`removeAdSelectionFromOutcomesConfigRemoteInfoOverride(RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` تزيل هذه القيمة الإعدادات المُلغاة لـ `AdSelectionFromOutcomesConfig` في Ad Selection API باستخدام البيانات المرتبطة في `RemoveAdSelectionOverrideRequest`.
`void`	`resetAllAdSelectionConfigRemoteOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` يزيل جميع بيانات الإلغاء الخاصة بـ `AdSelectionConfig` في واجهة برمجة تطبيقات اختيار الإعلانات.
`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()` تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.

الطرق العامة

تجاهُلAdSelectionConfigRemoteInfo

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

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

تلغي AdSelection API لـ AdSelectionConfig معيّن لتجنّب جلب البيانات من الخوادم البعيدة واستخدام البيانات المقدّمة في AddAdSelectionOverrideRequest بدلاً من ذلك. يتم توفير AddAdSelectionOverrideRequest من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات".

يُقصد استخدام هذه الطريقة للاختبار الشامل. لا يتم تفعيل واجهة برمجة التطبيقات هذه إلا لتطبيقات التي تعمل في وضع تصحيح الأخطاء مع تفعيل خيارات المطوّرين.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

المعلمات
`request`	`AddAdSelectionOverrideRequest`: لا يمكن أن تكون هذه القيمة `null`.
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال `Executor` هذا، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية لتطبيقك، يمكنك استخدام `Context.getMainExecutor()`. وبخلاف ذلك، يُرجى توفير `Executor` يتم إرسالها إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.

الرميات
`IllegalStateException`	إذا لم تكن واجهة برمجة التطبيقات هذه مفعَّلة للمتصل يعرض المستلِم إما `void` للإشارة إلى نجاح عملية التنفيذ، أو `Exception` للإشارة إلى الخطأ.

OverAdSelectionFromResultsConfigRemoteInfo

تمت الإضافة في Android UpsideDownCakePrivacySandbox

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

تلغي AdSelection API لـ AdSelectionFromOutcomesConfig لتجنّب جلب data من الخوادم البعيدة واستخدام البيانات المقدّمة في AddAdSelectionFromOutcomesOverrideRequest بدلاً من ذلك. توفّر حزمة SDK لإعلانات Google العنصر AddAdSelectionFromOutcomesOverrideRequest.

يُقصد استخدام هذه الطريقة للاختبار الشامل. لا يتم تفعيل واجهة برمجة التطبيقات هذه إلا لتطبيقات التي تعمل في وضع تصحيح الأخطاء مع تفعيل خيارات المطوّر.
تتطلب السمة 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 Extensions 4

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

يزيل إلغاء AdSelectionConfig في واجهة برمجة تطبيقات اختيار الإعلانات مع ربطه بالبيانات في RemoveAdSelectionOverrideRequest. توفّر حزمة SDK لإعلانات Google العنصر RemoveAdSelectionOverrideRequest.

المعلمات
`request`	`RemoveAdSelectionOverrideRequest`: لا يمكن أن تكون هذه القيمة `null`.
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث المُعلِم المرجعي وأحداث أداة مراقبة الأحداث من خلال هذه السلسلة `Executor`، ما يوفر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية لتطبيقك، يمكنك استخدام `Context.getMainExecutor()`. بخلاف ذلك، قدِّم `Executor` يُرسِل إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.

الرميات
`IllegalStateException`	إذا لم يتم تفعيل واجهة برمجة التطبيقات هذه للمتصل يعرض المستلِم إما `void` للإشارة إلى نجاح التنفيذ، أو `Exception` للإشارة إلى الخطأ.

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

تمت إضافتها في Android UpsideDownCakePrivacySandbox

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

تزيل هذه العملية عملية إلغاء لـ AdSelectionFromOutcomesConfig في Ad Selection API باستخدام البيانات المرتبطة في RemoveAdSelectionOverrideRequest. يتم توفير RemoveAdSelectionOverrideRequest من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات".

المعلمات
`request`	`RemoveAdSelectionFromOutcomesOverrideRequest`: لا يمكن أن تكون هذه القيمة `null`.
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث المُعلِم المرجعي وأحداث أداة مراقبة الأحداث من خلال هذه السلسلة `Executor`، ما يوفر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة المهام الرئيسية في تطبيقك، يمكنك استخدام `Context.getMainExecutor()`. بخلاف ذلك، قدِّم `Executor` يُرسِل إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.

الرميات
`IllegalStateException`	إذا لم تكن واجهة برمجة التطبيقات هذه مفعَّلة للمتصل يعرض المستلِم إما `void` للإشارة إلى نجاح عملية التنفيذ، أو `Exception` للإشارة إلى الخطأ.

resetAllAdSelectionConfigRemoteOverrides

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

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

تزيل جميع بيانات الاستبدال لـ AdSelectionConfig في Ad Selection API.

تم تصميم هذه الطريقة لاستخدامها في الاختبار الشامل. لا يتم تفعيل واجهة برمجة التطبيقات هذه إلا لتطبيقات التي تعمل في وضع تصحيح الأخطاء مع تفعيل خيارات المطوّرين.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

المعلمات

المعلمات
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال `Executor` هذا، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة المهام الرئيسية في تطبيقك، يمكنك استخدام `Context.getMainExecutor()`. بخلاف ذلك، قدِّم `Executor` يُرسِل إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.

executor

Executor: لا يمكن أن تكون هذه القيمة null. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال Executor هذا، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة المهام الرئيسية في تطبيقك، يمكنك استخدام Context.getMainExecutor(). بخلاف ذلك، قدِّم Executor يُرسِل إلى سلسلة محادثات مناسبة.

receiver

OutcomeReceiver: لا يمكن أن تكون هذه القيمة null.

الرميات
`IllegalStateException`	إذا لم تكن واجهة برمجة التطبيقات هذه مفعَّلة للمتصل يعرض المستلِم إما `void` للإشارة إلى نجاح عملية التنفيذ، أو `Exception` للإشارة إلى الخطأ.

resetAllAdSelectionFromOutcomesConfigRemoteOverrides

تمت الإضافة في Android UpsideDownCakePrivacySandbox

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

يزيل جميع بيانات الإلغاء الخاصة بـ AdSelectionFromOutcomesConfig في واجهة برمجة تطبيقات اختيار الإعلانات.

المعلمات

المعلمات
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث المُعلِم المرجعي وأحداث أداة مراقبة الأحداث من خلال هذه السلسلة `Executor`، ما يوفر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة المهام الرئيسية في تطبيقك، يمكنك استخدام `Context.getMainExecutor()`. بخلاف ذلك، قدِّم `Executor` يُرسِل إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.

executor

Executor: لا يمكن أن تكون هذه القيمة null. يتم إرسال أحداث المُعلِم المرجعي وأحداث أداة مراقبة الأحداث من خلال هذه السلسلة Executor، ما يوفر طريقة سهلة للتحكّم في سلسلة المحادثات التي يتم استخدامها. لإرسال الأحداث من خلال سلسلة المهام الرئيسية في تطبيقك، يمكنك استخدام Context.getMainExecutor(). بخلاف ذلك، قدِّم Executor يُرسِل إلى سلسلة محادثات مناسبة.

receiver

OutcomeReceiver: لا يمكن أن تكون هذه القيمة null.

الرميات
`IllegalStateException`	إذا لم يتم تفعيل واجهة برمجة التطبيقات هذه للمتصل يعرض المستلِم إما `void` للإشارة إلى نجاح التنفيذ، أو `Exception` للإشارة إلى الخطأ.