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

public class CustomAudienceManager
extends Object

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

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

الطرق العامة

الجلب الإضافي والانضمام إلى الجمهور

تمت الإضافة في 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`.