مدير الإعلانات

public class AdIdManager
extends Object

java.lang.Object
↳	android.adservices.adid.AdIdManager

يوفّر AdId Manager واجهات برمجة تطبيقات لحِزم التطبيقات وحِزم تطوير البرامج (SDK) للإعلانات للوصول إلى المعرِّف الإعلاني. المعرِّف الإعلاني هو معرّف فريد يمكن إعادة ضبطه لكلّ جهاز ويمكن للمستخدِم إعادة ضبطه. توفّر هذه الإعلانات للمستخدمين عناصر تحكّم أفضل وتزوّد المطوّرين بنظامًا عاديًا بسيطًا لمواصلة تحقيق الربح من تطبيقاتهم من خلال الإعلانات المخصّصة (المعروفة سابقًا باسم الإعلانات التي تستهدِف الاهتمامات).

ملخّص

الطرق المتاحة للجميع
`static AdIdManager`	`get(Context context)` طريقة المصنع لإنشاء مثيل AdIdManager.
`void`	`getAdId(Executor executor, OutcomeReceiver<AdId, Exception> callback)` اعرض المعرّف الإعلاني.

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

من الصف


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

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

احصل على

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

public static AdIdManager get (Context context)

طريقة المصنع لإنشاء مثيل AdIdManager.

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

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

getAdId

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

public void getAdId (Executor executor, 
                OutcomeReceiver<AdId, Exception> callback)

اعرض المعرّف الإعلاني.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_AD_ID

المعلّمات

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

executor

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

callback

OutcomeReceiver: تصبح معاودة الاتصال التي يتم استدعاؤها بعد adid متاحة أو يحدث خطأ. لا يمكن أن تكون هذه القيمة null.

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

الرميات
`IllegalStateException`	إذا لم تكن واجهة برمجة التطبيقات هذه متاحة.