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

ملخّص: الثوابت | الطرق المكتسَبة | الطُرق | الطرق المكتسَبة

معرِّف مجموعة التطبيقات

public class AppSetId
extends Object

java.lang.Object
↳	android.adservices.appsetid.AppSetId

---

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

تُمثِّل هذه السمة appSetID ونطاقه appSetId هذا من واجهة برمجة التطبيقات AppSetIdManager.getAppSetId(Executor, OutcomeReceiver). ويمكن أن يكون نطاق رقم التعريف لكل تطبيق أو كل حساب مطوّر برامج مرتبط بالمستخدم. يُستخدَم رقم تعريف AppSetId للإحصاءات ورصد المحتوى غير المرغوب فيه وتحديد عدد مرات الظهور ومنع الاحتيال في حالات الاستخدام على جهاز معيّن قد يحتاجه المستخدم لربط الاستخدام أو الإجراءات في مجموعة من التطبيقات التي تملكها مؤسسة.

ملخّص

الثوابت
int	SCOPE_APP يتم تحديد معرّف appSetId لأحد التطبيقات.
int	SCOPE_DEVELOPER يتم تحديد معرّف appSetId على حساب مطوّر برامج في متجر التطبيقات.

شركات الإنشاءات العامة
AppSetId(String appSetId, int appSetIdScope) إنشاء مثيل لـ AppSetId

الطرق المتاحة للجميع
boolean	equals(Object o) يشير إلى ما إذا كان هناك كائن آخر "يساوي" هذا الكائن.
String	getId() لاسترداد قيمة appSetId
int	getScope() تسترجع نطاق appSetId.
int	hashCode() لعرض قيمة رمز تجزئة للكائن.

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

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

الثوابت

تطبيق SCOPE

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

public static final int SCOPE_APP

يتم تحديد appSetId على مستوى أحد التطبيقات. سيكون لكل التطبيقات على الجهاز قيمة appSetId مختلفة.

القيمة الثابتة: 1 (0x00000001)

مطوّر_التطبيقات

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

public static final int SCOPE_DEVELOPER

يتم تحديد معرّف appSetId على حساب مطوّر برامج في متجر التطبيقات. سيكون لكل التطبيقات من المطوّر نفسه على الجهاز معرِّف appSetId نفسه على مستوى المطوّر.

القيمة الثابتة: 2 (0x00000002)

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

معرِّف مجموعة التطبيقات

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

public AppSetId (String appSetId, 
                int appSetIdScope)

إنشاء مثيل لـ AppSetId

المعلّمات
appSetId	String: تم إنشاؤها من قِبل مقدِّم الخدمة. لا يمكن أن تكون هذه القيمة null.
appSetIdScope	int: نطاق قيمة appSetId القيمة هي SCOPE_APP، أو SCOPE_DEVELOPER

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

علامة يساوي

تمّت الإضافة في المستوى 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 و y.equals(z) تعرض true، يجب أن تعرض 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.

getId

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

public String getId ()

لاسترداد قيمة appSetId تعرض واجهة برمجة التطبيقات دائمًا قيمة appSetId غير فارغة.

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

الحصول على نطاق

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

public int getScope ()

تسترجع نطاق appSetId.

الركلات المردودة
int	القيمة هي SCOPE_APP، أو SCOPE_DEVELOPER

رمز التجزئة

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

public int hashCode ()

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

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

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

بقدر ما هي عملية معقولة، فإنّ طريقة valueCode المحدّدة في الفئة Object تعرض أعدادًا صحيحة مختلفة للكائنات المختلفة. (قد يتم في وقت ما تنفيذ رمز التجزئة أو لا يتم تنفيذه كأحد وظائف عنوان ذاكرة العنصر).

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