FetchAndJoinCustomAudienceRequest

public final class FetchAndJoinCustomAudienceRequest
extends Object

java.lang.object
↳ android.adservices.customaudience.FetchAndJoinCustomAudienceRequest

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

fetchUri تنها پارامتر مورد نیاز است. نشان دهنده URI برای واکشی مخاطبان سفارشی از آن است. name ، activationTime ، expirationTime و userBiddingSignals پارامترهای اختیاری هستند. آنها یک مخاطب سفارشی جزئی را نشان می دهند که می تواند توسط تماس گیرنده برای اطلاع از انتخاب مخاطب سفارشی که کاربر باید به آن اضافه شود استفاده کند. هیچ فیلدی که توسط تماس گیرنده تنظیم شده است نمی تواند توسط مخاطبان سفارشی که از fetchUri واکشی شده اند نادیده گرفته شود. برای اطلاعات بیشتر در مورد هر زمینه به CustomAudience مراجعه کنید.

خلاصه

کلاس های تو در تو

class FetchAndJoinCustomAudienceRequest.Builder

سازنده اشیاء FetchAndJoinCustomAudienceRequest .

روش های عمومی

boolean equals ( Object o)

نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.

Instant getActivationTime ()

برای جزئیات به CustomAudience#getActivationTime() مراجعه کنید.

Instant getExpirationTime ()

برای جزئیات به CustomAudience#getExpirationTime() مراجعه کنید.

Uri getFetchUri ()
String getName ()

برای جزئیات به CustomAudience#getName() مراجعه کنید.

AdSelectionSignals getUserBiddingSignals ()

برای جزئیات به CustomAudience#getUserBiddingSignals() مراجعه کنید.

int hashCode ()

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

String toString ()

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

روش های ارثی

روش های عمومی

برابر است

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 ، این روش اگر و فقط اگر x و y به یک شی اشاره داشته باشند، true را برمی گرداند ( x == y مقدار true را دارد).

توجه داشته باشید که به طور کلی هر زمان که این روش نادیده گرفته می شود، باید متد hashCode را لغو کرد تا قرارداد کلی برای متد hashCode حفظ شود که بیان می کند که اشیاء مساوی باید دارای کدهای هش برابر باشند.

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

برمی گرداند
boolean فقط در صورتی true که دو شی FetchAndJoinCustomAudienceRequest حاوی اطلاعات یکسان باشند.

getActivationTime

public Instant getActivationTime ()

برای جزئیات به CustomAudience#getActivationTime() مراجعه کنید.

برمی گرداند
Instant Instant که با آن پیوستن به مخاطبان سفارشی به تاخیر می افتد. این مقدار ممکن است null باشد.

getExpirationTime

public Instant getExpirationTime ()

برای جزئیات به CustomAudience#getExpirationTime() مراجعه کنید.

برمی گرداند
Instant Instant تا زمانی که عضویت برای مخاطبان سفارشی منقضی می شود. این مقدار ممکن است null باشد.

getFetchUri

public Uri getFetchUri ()

برمی گرداند
Uri Uri که مخاطبان سفارشی باید از آن گرفته شوند. این مقدار نمی تواند null باشد.

getName

public String getName ()

برای جزئیات به CustomAudience#getName() مراجعه کنید.

برمی گرداند
String نام String مخاطب سفارشی برای پیوستن. این مقدار ممکن است null باشد.

getUserBiddingSignals

public AdSelectionSignals getUserBiddingSignals ()

برای جزئیات به CustomAudience#getUserBiddingSignals() مراجعه کنید.

برمی گرداند
AdSelectionSignals هنگامی که مخاطبان سفارشی در انتخاب آگهی شرکت می کنند، خریدار سیگنال می دهد که توسط جاوا اسکریپت ارائه شده توسط خریدار مصرف شود. این مقدار ممکن است null باشد.

هش کد

public int hashCode ()

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

قرارداد کلی hashCode به شرح زیر است:

  • هر گاه در طول اجرای یک برنامه جاوا بیش از یک بار بر روی یک شیء فراخوانی شود، متد hashCode باید به طور پیوسته همان عدد صحیح را برگرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسه‌های equals روی شی مورد استفاده قرار می‌گیرد تغییر نکند. لازم نیست این عدد صحیح از یک اجرای یک برنامه به اجرای دیگری از همان برنامه ثابت بماند.
  • اگر دو شی با توجه به متد equals(Object) برابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید یک عدد صحیح را ایجاد کند.
  • لازم نیست که اگر دو شی مطابق با متد equals(java.lang.Object) نابرابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید نتایج اعداد صحیح متمایز ایجاد کند. با این حال، برنامه نویس باید آگاه باشد که تولید نتایج اعداد صحیح متمایز برای اشیاء نابرابر ممکن است عملکرد جداول هش را بهبود بخشد.

تا آنجا که عملی است، متد hashCode که توسط کلاس Object تعریف شده است، اعداد صحیح متمایز را برای اشیاء مجزا برمی گرداند. (HashCode ممکن است به عنوان تابعی از آدرس حافظه یک شی در نقطه ای از زمان اجرا شود یا نباشد.)

برمی گرداند
int هش داده های شی FetchAndJoinCustomAudienceRequest .

toString

public String toString ()

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

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

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

برمی گرداند
String نمایشی قابل خواندن توسط انسان از FetchAndJoinCustomAudienceRequest .