برای گفتگو و ارائه بازخورد در مورد محصولات ما، به کانال رسمی AdMob Discord در سرور انجمن تبلیغات و اندازه‌گیری Google بپیوندید.

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

AbstractAdRequestBuilder

کاتلین | جاوا

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>

زیر کلاس های مستقیم شناخته شده AdManagerAdRequest.Builder ، AdRequest.Builder

`AdManagerAdRequest.Builder`	یک `AdManagerAdRequest` ایجاد می کند.
`AdRequest.Builder`	`AdRequest` ایجاد می کند.

یک کلاس سازنده پایه برای کمک به ساخت درخواست های تبلیغاتی.

خلاصه

توابع عمومی
`T!`	`@ CanIgnoreReturnValue addCustomEventExtrasBundle ( adapterClass: Class < CustomEvent !>!, customEventExtras: Bundle ! )` این تابع منسوخ شده است. به جای آن از `addNetworkExtrasBundle` استفاده کنید.
`T!`	`@ CanIgnoreReturnValue addCustomTargeting (key: String !, value: String !)` یک پارامتر هدف گذاری سفارشی اضافه می کند.
`T!`	`@ CanIgnoreReturnValue addCustomTargeting (key: String !, values: ( Mutable ) List < String !>!)` یک پارامتر هدف گیری سفارشی با چندین مقدار اضافه می کند.
`T!`	`@ CanIgnoreReturnValue addKeyword (keyword: String !)` یک کلمه کلیدی برای اهداف هدف اضافه می کند.
`T!`	`@ CanIgnoreReturnValue addNetworkExtrasBundle ( adapterClass: Class < MediationExtrasReceiver !>!, networkExtras: Bundle ! )` پارامترهای اضافی را برای ارسال به یک آداپتور شبکه تبلیغاتی خاص اضافه می کند.
`T!`	`@ CanIgnoreReturnValue setAdString (adString: String !)` یک رشته تبلیغات را تنظیم می کند که نشان دهنده یک پاسخ آگهی است.
`T!`	`@ CanIgnoreReturnValue setContentUrl (contentUrl: String !)` URL محتوا را برای وب سایتی تنظیم می کند که محتوای آن با محتوای اصلی برنامه مطابقت دارد.
`T!`	`@ CanIgnoreReturnValue setHttpTimeoutMillis (httpTimeoutMillis: Int )` یک مهلت زمانی سفارشی را برای تماس‌های HTTPS که توسط Google Mobile Ads SDK در طول درخواست آگهی برقرار می‌شود، تنظیم می‌کند.
`T!`	`@ CanIgnoreReturnValue setNeighboringContentUrls ( neighboringContentUrls: ( Mutable ) List < String !>! )` نشانی‌های اینترنتی را که محتوای وب را در نزدیکی آگهی نشان می‌دهند تنظیم می‌کند.
`T!`	`@ CanIgnoreReturnValue setRequestAgent (requestAgent: String !)` رشته عامل درخواست را برای شناسایی منشا درخواست آگهی تنظیم می کند.

توابع محافظت شده
`abstract T!`	`self ()` نمونه خود یک زیرنوع مشخص شده را برمی گرداند.

توابع عمومی

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

پارامترهای اضافی را برای ارسال به یک آداپتور رویداد سفارشی خاص اضافه می کند.

پارامترها
`adapterClass: Class < CustomEvent !>!`	`Class` آداپتور رویداد سفارشی که برای آن موارد اضافی ارائه می کنید.
`customEventExtras: Bundle !`	`Bundle` ای از اطلاعات اضافی برای انتقال به یک آداپتور رویداد سفارشی.

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

یک پارامتر هدف گذاری سفارشی اضافه می کند. تماس مجدد با همان کلید، مقادیر قدیمی را بازنویسی می کند.

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

یک پارامتر هدف گیری سفارشی با چندین مقدار اضافه می کند. تماس مجدد با همان کلید، مقادیر قدیمی را بازنویسی می کند.

کلمه کلیدی اضافه کنید

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

یک کلمه کلیدی برای اهداف هدف اضافه می کند.

افزودنNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

پارامترهای اضافی را برای ارسال به یک آداپتور شبکه تبلیغاتی خاص اضافه می کند.

پارامترها
`adapterClass: Class < MediationExtrasReceiver !>!`	`Class` آداپتوری که باید موارد اضافی را دریافت کند.
`networkExtras: Bundle !`	`Bundle` ای از اطلاعات اضافی برای انتقال به یک آداپتور میانجی.

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

یک رشته تبلیغات را تنظیم می کند که نشان دهنده یک پاسخ آگهی است. در صورت تنظیم، SDK این آگهی را ارائه می‌کند و همه اطلاعات هدف‌گیری تنظیم‌شده در این درخواست را نادیده می‌گیرد.

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

URL محتوا را برای وب سایتی تنظیم می کند که محتوای آن با محتوای اصلی برنامه مطابقت دارد. این محتوای وب سایت برای اهداف هدف گذاری و ایمنی برند استفاده می شود.

پرتاب می کند
`java.lang.NullPointerException`	اگر contentUrl {code null} است.
`java.lang.IllegalArgumentException`	اگر contentUrl خالی باشد یا طول آن از 512 بیشتر باشد.

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

یک مهلت زمانی سفارشی را برای تماس‌های HTTPS که توسط Google Mobile Ads SDK در طول درخواست آگهی برقرار می‌شود، تنظیم می‌کند.

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

پارامترها
`httpTimeoutMillis: Int`	یک عدد صحیح که زمان پایان HTTPS را بر حسب میلی ثانیه مشخص می کند. هر مقدار کمتر از `5000` (5 ثانیه) نادیده گرفته می شود. مقدار پیش فرض `60000` (60 ثانیه) است.

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

نشانی‌های اینترنتی را که محتوای وب را در نزدیکی آگهی نشان می‌دهند تنظیم می‌کند. ایمنی نام تجاری را ارتقا می دهد و به تبلیغات نمایش داده شده اجازه می دهد تا دارای رتبه بندی سطح برنامه (MA، T، PG و غیره) باشد که برای محتوای همسایه مناسب تر است.

پارامترها
`neighboringContentUrls: ( Mutable ) List < String !>!`	لیست URL های محتوای مجاور که باید به URL های محتوای همسایه موجود پیوست شود.

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

رشته عامل درخواست را برای شناسایی منشا درخواست آگهی تنظیم می کند. کتابخانه‌های شخص ثالثی که به SDK تبلیغات موبایلی اشاره می‌کنند، باید این روش را فراخوانی کنند تا پلتفرمی را که درخواست آگهی از آن منشا گرفته است، مشخص کند. به عنوان مثال، اگر یک شبکه تبلیغاتی شخص ثالث به نام "شبکه CoolAds" درخواست ها را به SDK تبلیغات موبایلی واسطه می کند، باید این روش را با "CoolAds" فراخوانی کند.

توابع محافظت شده

خود

protected abstract fun self(): T!

نمونه خود یک زیرنوع مشخص شده را برمی گرداند.