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

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

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

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

المعلمات
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.

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

resetAllAdSelectionFromOutcomesConfigRemoteOverrides

تمت الإضافة في 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 للإشارة إلى الخطأ.