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

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 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` في واجهة برمجة تطبيقات اختيار الإعلانات المرتبطة البيانات في `RemoveAdSelectionOverrideRequest`.
`void`	`removeAdSelectionFromOutcomesConfigRemoteInfoOverride(RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` يزيل إلغاء `AdSelectionFromOutcomesConfig` في واجهة برمجة تطبيقات اختيار الإعلانات باستخدام ربط البيانات في `RemoveAdSelectionOverrideRequest`.
`void`	`resetAllAdSelectionConfigRemoteOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` يزيل جميع بيانات الإلغاء الخاصة بـ `AdSelectionConfig` في واجهة برمجة تطبيقات اختيار الإعلانات.
`void`	`resetAllAdSelectionFromOutcomesConfigRemoteOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` يزيل جميع بيانات الإلغاء الخاصة بـ `AdSelectionFromOutcomesConfig` في واجهة برمجة تطبيقات اختيار الإعلانات.

الطرق المكتسبة

من الصف


        
          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 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 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 لتجنُّب جلب البيانات، البيانات من الخوادم البعيدة وتستخدم البيانات المقدمة في AddAdSelectionFromOutcomesOverrideRequest بدلاً من ذلك. يتم توفير AddAdSelectionFromOutcomesOverrideRequest من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات".

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

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

removeAdSelectionConfigRemoteInfoOverride

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

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

إزالة إلغاء AdSelectionConfig في واجهة برمجة تطبيقات Ad Selection API المرتبطة البيانات في شهر RemoveAdSelectionOverrideRequest. يتم توفير RemoveAdSelectionOverrideRequest من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات".

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

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

removeAdSelectionFromResultsConfigRemoteInfoOverride

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

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

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

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

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

إعادة ضبط AllAdSelectionConfigRemoteOverrides

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

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

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

المعلمات

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

executor

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

receiver

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

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

إعادة ضبطAllAdSelectionFromResultsConfigRemoteOverrides

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

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

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

المعلمات

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

executor

receiver

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

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