تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

بيانات الإعلان

public final class AdData
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.common.AdData

تمثّل هذه السمة بيانات خاصة بإعلان تكون ضرورية لاختيار الإعلان وعرضه.

ملخّص

الصفوف المتداخلة
`class`	`AdData.Builder` أداة إنشاء `AdData` عنصر

الثوابت المكتسَبة

من الواجهة android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` وحدة بت الواصف المستخدمة مع `describeContents()`: تشير إلى أن يتضمن التمثيل المسطَّح للكائن القابل للبرمجة واصف الملف.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` علامة للاستخدام مع `writeToParcel(Parcel, int)`: الكائن الذي تتم كتابته هي القيمة المعروضة، التي هي نتيجة دالة مثل "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`"، أو "`void someFunction(inout Parcelable)`".

الحقول
`public static final Creator<AdData>`	`CREATOR`

الطرق العامة
`boolean`	`equals(Object o)` تتحقّق مما إذا كان كائنان `AdData` يحتويان على المعلومات نفسها.
`Set<Integer>`	`getAdCounterKeys()` للحصول على مجموعة المفاتيح المستخدمة في عدّ الأحداث.
`AdFilters`	`getAdFilters()` ربط جميع `AdFilters` بالإعلان.
`String`	`getAdRenderId()` الحصول على رقم تعريف عرض الإعلان لمزادات الخوادم
`String`	`getMetadata()` الحصول على البيانات الوصفية لإعلانات المشتري المستخدمة أثناء عملية اختيار الإعلانات
`Uri`	`getRenderUri()` يحصل على معرّف الموارد المنتظم (URI) الذي يشير إلى مواد عرض عرض الإعلان.
`int`	`hashCode()` تعرض تجزئة بيانات عنصر `AdData`.
`String`	`toString()` تعرض تمثيلاً سلسلة للكائن.
`void`	`writeToParcel(Parcel dest, int flags)` عليك تسوية هذا العنصر في قطعة أرض.

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

من الصف


        
          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.os.Parcelable

`abstract int`	`describeContents()` وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم.
`abstract void`	`writeToParcel(Parcel dest, int flags)` عليك تسوية هذا العنصر في قطعة أرض.

الحقول

صانع محتوى

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

public static final Creator<AdData> CREATOR

الطرق العامة

علامة يساوي

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

public boolean equals (Object o)

تتحقّق مما إذا كان كائنان AdData يحتويان على المعلومات نفسها.

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

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

الحصول على مفاتيح عدّاد الإعلانات

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public Set<Integer> getAdCounterKeys ()

للحصول على مجموعة المفاتيح المستخدمة في عدّ الأحداث.

لا يجوز ربط أكثر من 10 مفاتيح لعدّاد الإعلانات بالإعلان.

تُستخدَم المفاتيح والأرقام لكل مفتاح في فلترة تحديد عدد مرات الظهور أثناء اختيار الإعلان استبعاد الإعلانات المرتبطة من الإرسال إلى عروض الأسعار

تجدر الإشارة إلى أنّه يمكن استبدال هذه المفاتيح إلى جانب الإعلانات وبيانات عروض الأسعار الأخرى جمهور مخصّص أثناء التحديث اليومي للجمهور المخصّص.

المرتجعات
`Set<Integer>`	لا يمكن أن تكون هذه القيمة `null`.

الحصول على فلاتر الإعلانات

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public AdFilters getAdFilters ()

ربط جميع AdFilters بالإعلان.

الفلاتر، في حال بلوغها أو تجاوزها، تستثني الإعلان المرتبط من المشاركة في الإعلان التحديد. وهي اختيارية، وفي حال تحديد null عدم تطبيق أي فلاتر على هذا الإعلان.

المرتجعات
`AdFilters`

معرّف getAdRenderId

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public String getAdRenderId ()

الحصول على رقم تعريف عرض الإعلان لمزادات الخوادم

يتم جمع رقم تعريف عرض الإعلان لكل AdData عند تلقّي طلب المزاد من الخادم.

لن تكون أي AdData لا تحتوي على معرّف عرض الإعلان مؤهلة للمزاد من جهة الخادم.

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

الحصول على البيانات الوصفية

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

public String getMetadata ()

الحصول على البيانات الوصفية لإعلانات المشتري المستخدمة أثناء عملية اختيار الإعلانات

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

إذا لم تكن البيانات الوصفية عنصر JSON صالحًا يمكن استخدامه بواسطة JavaScript للمشتري، سيتم لن يكون مؤهلاً لاختيار الإعلانات.

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

الحصول على RenderUri

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

public Uri getRenderUri ()

يحصل على معرّف الموارد المنتظم (URI) الذي يشير إلى مواد عرض عرض الإعلان. يجب أن يستخدم معرِّف الموارد المنتظم (URI) بروتوكول HTTPS.

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

رمز التجزئة

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

public int hashCode ()

تعرض تجزئة بيانات عنصر AdData.

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

إلىسلسلة

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

public String toString ()

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

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

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

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

كتابة ToParcel

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

public void writeToParcel (Parcel dest, 
                int flags)

عليك تسوية هذا العنصر في قطعة أرض.

المعلمات
`dest`	`Parcel`: لا يمكن أن تكون هذه القيمة `null`.
`flags`	`int`: علامات إضافية حول الطريقة التي يجب كتابة العنصر بها قد تكون القيمة 0 أو `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`. القيمة هي `0` أو مجموعة من `Parcelable.PARCELABLE_WRITE_RETURN_VALUE` وandroid.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES