AdIdManager

public class AdIdManager
extends Object

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

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

ملخّص

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

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

من الفئة


        
          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
وأيضاً في Ad Services Extensions 4

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

عرض AdId
تتطلب السمة 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`	إذا لم تكن واجهة برمجة التطبيقات هذه متاحة.