تمت الإضافة في المستوى 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) لعرض الإعلانات".

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

المعلمات
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) لعرض الإعلانات".

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

المعلمات
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) لعرض الإعلانات".

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

المعلمات
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 في واجهة برمجة تطبيقات اختيار الإعلانات.

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

المعلمات
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 في واجهة برمجة تطبيقات اختيار الإعلانات.

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

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

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