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

ملخص: الثابت | المشرفون | الطُرق | الطرق المكتسبة

الرقم التعريفي للإعلان

public class AdId
extends Object

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

---

معرّف فريد لكل ملف شخصي يمكن إعادة ضبطه على مستوى الجهاز، ويمكن استخدامه لعرض الإعلانات

يجوز لشبكات الإعلانات استخدام AdId لتحقيق الربح من الإعلانات التي تستهدف الاهتمامات، أي الاستهداف وإعلانات تجديد النشاط التسويقي. يجوز للمستخدم الحدّ من توفّر هذا المعرّف.

يُرجى الاطّلاع أيضًا على:

• AdIdManager.getAdId(Executor, OutcomeReceiver)

ملخّص

الثوابت
String	ZERO_OUT هذه السمة ad id يتم عرضها عندما يكون لدى المستخدم limited ad tracking.

شركة إنشاءات عامة
AdId(String adId, boolean limitAdTrackingEnabled) ينشئ مثيلاً لـ AdId

الطرق العامة
boolean	equals(Object o) يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.
String	getAdId() المعرِّف الإعلاني.
int	hashCode() تعرض قيمة رمز التجزئة للكائن.
boolean	isLimitAdTrackingEnabled() لاسترداد إعداد الحدّ الأقصى المسموح به لتتبّع الإعلانات.
String	toString() تعرض تمثيلاً سلسلة للكائن.

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

من الصف 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 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public static final String ZERO_OUT

هذه السمة ad id يتم عرضها عندما يكون لدى المستخدم limited ad tracking.

القيمة الثابتة: "00000000-0000-0000-0000-000000000000"

شركة إنشاءات عامة

الرقم التعريفي للإعلان

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

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

ينشئ مثيلاً لـ AdId

المعلمات
adId	String: تم الحصول عليه من خدمة مقدّم الخدمة لا يمكن أن تكون هذه القيمة null.
limitAdTrackingEnabled	boolean: قيمة من خدمة المزوِّد التي تحدد قيمة الرقم التعريفي للإعلان.

الطرق العامة

علامة يساوي

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

public boolean equals (Object o)

يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.

تنفذ طريقة equals علاقة تكافؤ على مراجع الكائنات غير الفارغة:

• أنها انعكاسية: لأي قيمة مرجعية غير فارغة x، x.equals(x) يجب أن يعود true
• أنه متماثل: لأي قيم مرجعية غير فارغة x وy وx.equals(y) يجب أن تعرض القيمة true فقط إذا تُرجع "y.equals(x)" القيمة true.
• طريقة العرض متعدّدة: لأي قيم مرجعية غير فارغة x وy وz، إذا تقوم x.equals(y) بإرجاع true يتم إرجاع مبلغ true من قِبل y.equals(z)، ثم يجب أن يعرض x.equals(z) true.
• متسقة: لأي قيم مرجعية غير فارغة x وy، استدعاءات متعددة x.equals(y) يعرض true باستمرار أو عرض false باستمرار، بشرط ألا المعلومات المستخدمة في مقارنات equals على تعديل الكائنات.
• بالنسبة إلى أي قيمة مرجعية غير فارغة للسمة x، يجب أن تعرض x.equals(null) القيمة false.

يتم تنفيذ الطريقة equals للفئة Object علاقة التكافؤ الممكنة الأكثر تمييزًا بين الكائنات؛ أي، لأي قيم مرجعية غير فارغة x y، تعرض هذه الطريقة القيمة true إذا كانت إذا كان x وy يشيران إلى الكائن نفسه (القيمة x == y هي true).

تجدر الإشارة إلى أنّه من الضروري بوجه عام إلغاء hashCode. متى يتم إلغاء هذه الطريقة، وذلك للحفاظ على عقد عام لطريقة hashCode، والذي ينص على أن الكائنات المتساوية يجب أن تحتوي على رموز تجزئة متساوية.

المعلمات
o	Object: الكائن المرجعي المطلوب المقارنة معه

المرتجعات
boolean	true إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ false بخلاف ذلك.

getAdId

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

public String getAdId ()

المعرِّف الإعلاني.

تعتمد قيمة المعرِّف الإعلاني على الجمع بين isLimitAdTrackingEnabled() وAdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

عندما يكون المستخدم limiting ad tracking، تعرض واجهة برمجة التطبيقات ZERO_OUT وهذا لا يسمح للمتصل بتتبّع المستخدم لأغراض تحقيق الربح.

وبخلاف ذلك، يتم عرض سلسلة فريدة للجهاز والمستخدم، والتي يمكن استخدامها لتتبع المستخدمين لأغراض الإعلان.

المرتجعات
String	لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

public int hashCode ()

تعرض قيمة رمز التجزئة للكائن. هذه الطريقة لصالح جداول التجزئة مثل تلك التي توفرها HashMap

العقد العام لشركة "hashCode" هو:

• عندما يتم استدعاءها على الكائن نفسه أكثر من مرة أثناء هو تنفيذ تطبيق Java، الطريقة hashCode يجب أن تعرض باستمرار العدد الصحيح نفسه، بدون تقديم أي معلومات يتم تعديل استخدامها في مقارنات equals على الكائن. لا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ واحدة التطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه.
• إذا كان هناك كائنان متساويان وفقًا لـ equals(Object) ثم استدعاء طريقة hashCode في كل من يجب أن يُنتج الكائنان نفس نتيجة العدد الصحيح.
• ليس من الضروري أن يكون هناك كائنان غير متساويين بِحَسَبْ equals(java.lang.Object) ثم استدعاء طريقة hashCode في كل يجب أن ينتج عن كائنين نتائج أعداد صحيحة مميزة. ومع ذلك، يجب أن يكون المبرمج على علم بأنّ إنتاج نتائج أعداد صحيحة مميّزة للكائنات غير المتساوية إلى تحسين أداء جداول التجزئة.

بقدر ما يكون عمليًا بشكل معقول، تم تحديد طريقة التجزئة حسب الفئة Object يتم إرجاع أعداد صحيحة مميزة الكائنات المميزة. (قد يتم تنفيذ رمز التجزئة أو لا كدالة معينة لعنوان ذاكرة الكائن عند نقطةٍ ما في الوقت المناسب).

المرتجعات
int	قيمة رمز التجزئة لهذا الكائن.

islimitedAdTrackingEnabled

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

public boolean isLimitAdTrackingEnabled ()

لاسترداد إعداد الحدّ الأقصى المسموح به لتتبّع الإعلانات.

تكون هذه القيمة صحيحة إذا فعّل المستخدم الحدّ من تتبُّع الإعلانات، أو false.

المرتجعات
boolean

إلىسلسلة

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

public String toString ()

تعرض تمثيلاً سلسلة للكائن. بشكل عام، تُرجع طريقة toString سلسلة "يمثل نصيًا" لهذا الكائن. يجب أن تكون النتيجة أن يكون تمثيلاً موجزًا وغنيًا بالمعلومات ويسهل على الشخص المراد قراءته. من المستحسن أن تتجاهل جميع الفئات الفرعية هذه الطريقة.

استخدام الطريقة toString للفئة Object تُنتج سلسلة تتكون من اسم الفئة التي هو مثيل، فإن حرف علامة @ `@'، التمثيل السداسي العشري غير الموقع لرمز التجزئة الخاص بك. بعبارة أخرى، تُرجع هذه الطريقة سلسلة تساوي قيمة:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

المرتجعات
String	تمثيل سلسلة للكائن.