مدير الجمهور المخصّص

public class CustomAudienceManager
extends Object

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

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

ملخّص

الطرق المتاحة للجميع
`void`	`fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` لإضافة المستخدم إلى `CustomAudience` التي تم جلبها من `fetchUri`
`static CustomAudienceManager`	`get(Context context)` الطريقة الأصلية لإنشاء مثيل Custom AudienceManager
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` إنشاء خدمة باستخدام واجهات برمجة التطبيقات التي تتيح الاختبار
`void`	`joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` لإضافة المستخدم إلى `CustomAudience` المقدمة.
`void`	`leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` محاولة إزالة مستخدم من جمهور مخصّص عن طريق حذف أيّ بيانات `CustomAudience` حالية، تم تحديدها من خلال `ownerPackageName` و`buyer` و`name`.

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

من الصف


        
          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()` يؤدي إلى انتظار سلسلة المحادثات الحالية إلى أن يتم تنشيطها، وعادةً من خلال إشعارها أو مقاطعتها.

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

segmentationAndJoinCustomUrl

مضاف في Android UpsideDownCakePrivacySandbox

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

لإضافة المستخدم إلى CustomAudience التي تم جلبها من fetchUri

ستؤدي محاولة تسجيل المستخدِم في شريحة جمهور مخصّصة باستخدام المجموعة نفسها من ownerPackageName وbuyer وname إلى استبدال معلومات الجمهور المخصّص الحالي، بما في ذلك قائمة بيانات الإعلانات.

تجدر الإشارة إلى أنه يمكن استبدال قائمة الإعلانات بالكامل بمهمة الجلب اليومية في الخلفية.

تعذَّر إجراء هذه المكالمة مع SecurityException إذا

لا يتصل ownerPackageName باسم حزمة التطبيق و/أو
غير مصرح للمشتري باستخدام واجهة برمجة التطبيقات.

تعذَّر إجراء هذه المكالمة مع IllegalArgumentException إذا

تجاوز تطبيق الاتصال الحدّ الأقصى المسموح به لمساحة التخزين
لا تتم مصادقة أي معلمات URI في CustomAudience المقدمة مع المشتري CustomAudience.

يتعذّر تنفيذ هذا الطلب من خلال LimitExceededException إذا كانت حزمة الاتصال تتجاوز حدود السعر المسموح به وتم تقييدها.

يتعذّر تنفيذ هذا الاستدعاء مع ظهور الخطأ IllegalStateException في حال حدوث خطأ داخلي في الخدمة.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

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

احصل على

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

public static CustomAudienceManager get (Context context)

الطريقة الأصلية لإنشاء مثيل Custom AudienceManager

المعلّمات
`context`	`Context`: لا يمكن استخدام `Context` لهذه القيمة باعتبارها `null`.

الركلات المردودة
`CustomAudienceManager`	مثيل `CustomAudienceManager` لا يمكن أن تكون هذه القيمة `null`.

getTestCustomAudienceManager

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

public TestCustomAudienceManager getTestCustomAudienceManager ()

إنشاء خدمة باستخدام واجهات برمجة التطبيقات التي تتيح الاختبار

الركلات المردودة
`TestCustomAudienceManager`	لا يمكن أن تكون هذه القيمة `null`.

الانضمام إلى شريحة جمهور مخصّصة

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

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

لإضافة المستخدم إلى CustomAudience المقدمة.

تجدر الإشارة إلى أنه يمكن استبدال قائمة الإعلانات بالكامل بمهمة الجلب اليومية في الخلفية.

تعذَّر إجراء هذه المكالمة مع SecurityException إذا

لا يتصل ownerPackageName باسم حزمة التطبيق و/أو
غير مصرح للمشتري باستخدام واجهة برمجة التطبيقات.

تعذَّر إجراء هذه المكالمة مع IllegalArgumentException إذا

تجاوز تطبيق الاتصال الحدّ الأقصى المسموح به لمساحة التخزين
لا تتم مصادقة أي معلمات URI في CustomAudience المقدمة مع المشتري CustomAudience.

يتعذّر تنفيذ هذا الطلب من خلال LimitExceededException إذا كانت حزمة الاتصال تتجاوز حدود السعر المسموح به وتم تقييدها.

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

مغادرة Custom Audience (جمهور مخصص)

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

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

محاولة إزالة مستخدم من جمهور مخصّص عن طريق حذف أيّ بيانات CustomAudience حالية، تم تحديدها من خلال ownerPackageName وbuyer وname.

تعذَّر إجراء هذه المكالمة مع SecurityException إذا

لا يستدعي ownerPackageName اسم حزمة التطبيق، و/أو
غير مصرح للمشتري باستخدام واجهة برمجة التطبيقات.

يتعذّر تنفيذ هذا الطلب من خلال LimitExceededException إذا كانت حزمة الاتصال تتجاوز حدود السعر المسموح به وتم تقييدها.

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

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