TestAdSelectionManager

public class TestAdSelectionManager
extends Object

java.lang.Object
↳ android.adservices.adsselect.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 Select API مع البيانات المرتبطة في RemoveAdSelectionOverrideRequest.

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

إزالة عنصر إلغاء AdSelectionFromOutcomesConfig في واجهة برمجة التطبيقات Ad Select 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

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

الطرق المتاحة للجميع

تجاوزAdSelectionConfigRemoteInfo

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 إلى الخطأ.

تجاوزAdSelectionFromResultsConfigRemoteInfo

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

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

يؤدي هذا الخيار إلى إزالة عملية إلغاء AdSelectionConfig في واجهة برمجة التطبيقات Ad Select 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

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

إزالة عنصر إلغاء AdSelectionFromOutcomesConfig في واجهة برمجة التطبيقات Ad Select 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 إلى الخطأ.

إعادة ضبط كلAdSelectionConfigRemoteOverrides

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 إلى الخطأ.

إعادة ضبط كلAdSelectionFrom ResultssConfigRemoteOverrides

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

إزالة جميع بيانات الإلغاء لـ AdSelectionFromOutcomesConfig في واجهة برمجة التطبيقات Ad Selection API

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

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

ويعرِض المُستلِم إمّا void للتشغيل الناجح، أو تشير القيمة Exception إلى الخطأ.