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

سازنده درخواست تبلیغات انتزاعی

public abstract class AbstractAdRequestBuilder<T extends AbstractAdRequestBuilder<T>>

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

`AdManagerAdRequest.Builder`	یک `AdManagerAdRequest` می‌سازد.
`AdRequest.Builder`	یک `AdRequest` می‌سازد.

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

خلاصه

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

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

روش‌های عمومی

addCustomEventExtrasBundle

@CanIgnoreReturnValue
public T addCustomEventExtrasBundle(
    Class<CustomEvent> adapterClass,
    Bundle customEventExtras
)

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

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

افزودن هدف‌گذاری سفارشی

@CanIgnoreReturnValue
public T addCustomTargeting(String key, String value)

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

افزودن هدف‌گذاری سفارشی

@CanIgnoreReturnValue
public T addCustomTargeting(String key, List<String> values)

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

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

@CanIgnoreReturnValue
public T addKeyword(String keyword)

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

بسته‌ی addNetworkExtras

@CanIgnoreReturnValue
public T addNetworkExtrasBundle(
    Class<MediationExtrasReceiver> adapterClass,
    Bundle networkExtras
)

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

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

تنظیم رشته تبلیغات

@CanIgnoreReturnValue
public T setAdString(String adString)

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

آدرس اینترنتی (URL) را تنظیم کنید

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

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

پرتاب‌ها
`java.lang.NullPointerException`	اگر contentUrl برابر با {code null} باشد.
`java.lang.IllegalArgumentException`	اگر contentUrl خالی باشد، یا اگر طول آن از ۵۱۲ بیشتر باشد.

setHttpTimeoutMillis

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

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

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

پارامترها
`int httpTimeoutMillis`	یک عدد صحیح که زمان انقضای HTTPS را بر حسب میلی‌ثانیه مشخص می‌کند. هر مقداری کمتر از `5000` (۵ ثانیه) نادیده گرفته می‌شود. مقدار پیش‌فرض `60000` (۶۰ ثانیه) است.

آدرس‌های محتوای همسایه را تنظیم کنید

@CanIgnoreReturnValue
public T setNeighboringContentUrls(List<String> neighboringContentUrls)

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

پارامترها
`List < String > neighboringContentUrls`	فهرست URLهای محتوای همسایه که باید به URLهای محتوای همسایه موجود پیوست شوند.

شناسه‌ی جایگذاری را تنظیم کنید

@CanIgnoreReturnValue
public T setPlacementId(long placementId)

یک شناسه قرارگیری پیش‌فرض برای تبلیغ بارگذاری‌شده تنظیم می‌کند.

برای بنرهای تبلیغاتی، توصیه می‌شود به جای آن setPlacementId استفاده کنید. فراخوانی loadAd با درخواستی که یک شناسه قرارگیری را تنظیم می‌کند، همان تأثیر فراخوانی setPlacementId را دارد.

پارامترها
`long placementId`	یک عدد صحیح طولانی که توسط رابط کاربری AdMob برای مکان‌یابی پیکربندی‌شده ارائه شده است.

setRequestAgent

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

روش‌های محافظت‌شده

خود

protected abstract T self()

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