اختبار Custom AudienceManager

public class TestCustomAudienceManager
extends Object

java.lang.Object
↳	android.adservices.customaudience.TestCustomAudienceManager

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

ملخّص

الطرق المتاحة للجميع
`void`	`overrideCustomAudienceRemoteInfo(AddCustomAudienceOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` لإلغاء Custom Audience API بهدف تجنُّب استرجاع البيانات من الخوادم البعيدة واستخدام البيانات المقدّمة في `AddCustomAudienceOverrideRequest` بدلاً من ذلك.
`void`	`removeCustomAudienceRemoteInfoOverride(RemoveCustomAudienceOverrideRequest request, Executor executor, OutcomeReceiver<Object, Exception> receiver)` إزالة عملية إلغاء في Custom Audience API مع البيانات المرتبطة في `RemoveCustomAudienceOverrideRequest`
`void`	`resetAllCustomAudienceOverrides(Executor executor, OutcomeReceiver<Object, Exception> receiver)` إزالة جميع بيانات الإلغاء في Custom Audience 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()` يؤدي إلى انتظار سلسلة المحادثات الحالية إلى أن يتم تنشيطها، وعادةً من خلال إشعارها أو مقاطعتها.

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

إلغاء Custom AudienceRemoteInfo

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

public void overrideCustomAudienceRemoteInfo (AddCustomAudienceOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

لإلغاء Custom Audience API بهدف تجنُّب استرجاع البيانات من الخوادم البعيدة واستخدام البيانات المقدّمة في AddCustomAudienceOverrideRequest بدلاً من ذلك. يتم توفير AddCustomAudienceOverrideRequest من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات".

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

سيتم تنفيذ هذه المكالمة تلقائيًا إذا لم يكن owner في request هو اسم حزمة تطبيق الاتصال.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

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

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

removeCustomAudienceRemoteInfoOverride

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

public void removeCustomAudienceRemoteInfoOverride (RemoveCustomAudienceOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

إزالة عملية إلغاء في Custom Audience API مع البيانات المرتبطة في RemoveCustomAudienceOverrideRequest

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

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

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

إعادة ضبط AllCustom AudienceOverrides

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

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

إزالة جميع بيانات الإلغاء في Custom Audience API.

المعلّمات

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

executor

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

receiver

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

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