این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

خلاصه: کلاس های تو در تو | ثابت های ارثی | فیلدها | روش ها | روش های ارثی

AdData

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()` استفاده می شود: نشان می دهد که نمایش مسطح شیء Parcelable شامل یک توصیفگر فایل است.
`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 ()` انواع اشیاء ویژه موجود در نمایش مارشال شده این نمونه Parcelable را شرح دهید.
`abstract void`	`writeToParcel ( Parcel dest, int flags)` این شی را در یک بسته صاف کنید.

فیلدها

خالق

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

public static final Creator<AdData> CREATOR

روش های عمومی

برابر است

در سطح API 34 اضافه شد

public boolean equals (Object o)

بررسی می کند که آیا دو شی AdData حاوی اطلاعات یکسانی هستند یا خیر.

پارامترها
`o`	`Object` : شی مرجعی که با آن مقایسه می شود.

برمی گرداند
`boolean`	`true` اگر این شی همان آرگومان obj باشد. `false` در غیر این صورت

getAdCounterKeys

در Android UpsideDownCakePrivacySandbox اضافه شد

public Set<Integer> getAdCounterKeys ()

مجموعه کلیدهای مورد استفاده در شمارش رویدادها را دریافت می کند.

نباید بیش از 10 کلید شمارنده آگهی با یک آگهی مرتبط شود.

کلیدها و تعداد هر کلید در فیلتر کردن محدودیت فرکانس در هنگام انتخاب آگهی استفاده می‌شود تا آگهی‌های مرتبط را از ارائه به مناقصه رد کند.

توجه داشته باشید که این کلیدها را می‌توان همراه با آگهی‌ها و سایر داده‌های پیشنهادی برای مخاطبان سفارشی در طول به‌روزرسانی روزانه مخاطبان سفارشی بازنویسی کرد.

برمی گرداند
`Set < Integer >`	این مقدار نمی تواند `null` باشد.

getAdFilters

در Android UpsideDownCakePrivacySandbox اضافه شد

public AdFilters getAdFilters ()

همه AdFilters مرتبط با آگهی را دریافت می کند.

فیلترها، در صورت رعایت یا فراتر از آن، آگهی مرتبط را از شرکت در انتخاب آگهی حذف می‌کنند. آنها اختیاری هستند و در صورت null مشخص کنید که هیچ فیلتری برای این تبلیغ اعمال نمی شود.

برمی گرداند
`AdFilters`

getAdRenderId

در Android UpsideDownCakePrivacySandbox اضافه شد

public String getAdRenderId ()

شناسه رندر آگهی را برای مزایده های سرور دریافت می کند.

هنگامی که درخواست مزایده سرور دریافت می شود، شناسه رندر آگهی برای هر AdData جمع آوری می شود.

هر AdData بدون شناسه رندر آگهی برای حراج سمت سرور واجد شرایط نخواهد بود.

برمی گرداند
`String`	این مقدار ممکن است `null` باشد.

دریافت متادیتا

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

public String getMetadata ()

فراداده آگهی خریدار را در طول فرآیند انتخاب آگهی استفاده می کند.

ابرداده باید یک شیء معتبر JSON باشد که به صورت رشته ای سریال شده است. فراداده اطلاعات مناقصه خاص آگهی را نشان می دهد که در هنگام انتخاب آگهی به عنوان بخشی از تولید پیشنهاد استفاده می شود و در منطق جاوا اسکریپت خریدار استفاده می شود که در یک محیط اجرای ایزوله اجرا می شود.

اگر ابرداده یک شیء JSON معتبر نباشد که بتواند توسط JS خریدار مصرف شود، آگهی برای انتخاب آگهی واجد شرایط نخواهد بود.

برمی گرداند
`String`	این مقدار نمی تواند `null` باشد.

getRenderUri

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4

public Uri getRenderUri ()

URI را دریافت می کند که به دارایی های رندر آگهی اشاره می کند. URI باید از HTTPS استفاده کند.

برمی گرداند
`Uri`	این مقدار نمی تواند `null` باشد.

هش کد

در سطح API 34 اضافه شد

public int hashCode ()

هش داده های شی AdData را برمی گرداند.

برمی گرداند
`int`	یک مقدار کد هش برای این شی.

toString

در سطح API 34 اضافه شد

public String toString ()

یک نمایش رشته ای از شی را برمی گرداند. به طور کلی، متد toString رشته‌ای را برمی‌گرداند که به صورت متنی این شی را نشان می‌دهد. نتیجه باید یک نمایش مختصر اما آموزنده باشد که خواندن آن برای شخص آسان باشد. توصیه می شود که همه زیر کلاس ها این روش را لغو کنند.

متد toString برای کلاس Object رشته‌ای متشکل از نام کلاسی که شی نمونه‌ای از آن است، کاراکتر at-sign « @ » و نمایش هگزادسیمال بدون علامت کد هش شی را برمی‌گرداند. به عبارت دیگر، این متد رشته ای برابر با مقدار:

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

برمی گرداند
`String`	نمایش رشته ای از شی.

writeToParcel

در سطح API 34 اضافه شد

public void writeToParcel (Parcel dest, 
                int flags)

این شی را در یک بسته صاف کنید.

پارامترها
`dest`	`Parcel` : این مقدار نمی تواند `null` باشد.
`flags`	`int` : پرچم های اضافی درباره نحوه نوشتن شی. ممکن است 0 یا `Parcelable.PARCELABLE_WRITE_RETURN_VALUE` باشد.PARCELABLE_WRITE_RETURN_VALUE. مقدار `0` است یا ترکیبی از `Parcelable.PARCELABLE_WRITE_RETURN_VALUE` و android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES