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

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()

מחזירה ערך גיבוב (hash) של האובייקט.

String toString()

מחזירה ייצוג במחרוזת של האובייקט.

שיטות שעברו בירושה

שיטות ציבוריות

שווה ל-

public boolean equals (Object o)

מציין אם אובייקט אחר הוא "שווה ל" הזה.

השיטה equals מטמיעים יחס שקילות בהפניות לאובייקטים שאינם אפס:

  • הגדרה רפלקטיבית: לכל ערך הפניה שהוא לא null x, x.equals(x) אמור לחזור true
  • הערך הוא סימטרי: לכל ערכי הפניה שאינם אפס x וגם y, x.equals(y) צריך להחזיר את הערך true אם ורק אם הפונקציה y.equals(x) מחזירה true.
  • הוא מעבר: לכל ערכי הפניה שאינם null x, y וגם z, אם x.equals(y) מחזירה true ו y.equals(z) מחזירה true, ואז x.equals(z) אמור להחזיר true.
  • הוא עקבי: לכל ערכי הפניה שאינם null x ו-y, מספר הפעלות של x.equals(y) מחזיר true באופן עקבי או להחזיר בעקביות false, בתנאי שלא מידע שמשמש בהשוואות של equals אובייקטים הם משתנים.
  • לכל ערך הפניה שהוא לא אפס, x הפונקציה x.equals(null) צריכה להחזיר את הערך false.

ה-method equals למחלקה Object מיושמת את יחס השקילות האפשריים ביותר על אובייקטים; כלומר, לכל ערכי הפניה שאינם אפסיים x וגם y, השיטה הזו מחזירה true אם ורק אם x ו-y מתייחסים לאותו אובייקט (x == y יש את הערך true).

לתשומת ליבכם: בדרך כלל יש צורך בשינוי מברירת המחדל של hashCode בכל פעם שמחליפים את השיטה, כדי לשמור על חוזה כללי ל-method hashCode, שקובעת שאובייקטים שווים חייבים להיות בעלי קודי גיבוב (hash) שווים.

פרמטרים
o Object: אובייקט ההפניה שאליו תשוו.
החזרות
boolean true רק אם שני אובייקטים של FetchAndJoinCustomAudienceRequest מכילים אותו מידע.

getactivateTime

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 את האותות של הקונה שצריך להשתמש בו על ידי קוד ה-JavaScript שסופק על ידי הקונה, הקהל משתתף בבחירת מודעה. הערך הזה יכול להיות null.

קוד גיבוב (hashCode)

public int hashCode ()

מחזירה ערך גיבוב (hash) של האובייקט. השיטה הזאת נתמך לטובת טבלאות גיבוב (hash), כמו אלה שמסופקות על ידי HashMap

החוזה הכללי של hashCode הוא:

  • בכל פעם שהוא מופעל על אותו אובייקט יותר מפעם אחת במהלך הרצה של אפליקציה ב-Java, ה-method hashCode צריך להחזיר בעקביות את אותו מספר שלם, כל עוד אין מידע שנעשה בו שימוש בהשוואות של equals באובייקט. המספר השלם הזה לא צריך להיות עקבי מהפעלה אחת של לביצוע אחר של אותה האפליקציה.
  • אם שני אובייקטים שווים לפי equals(Object) ואז קריאה ל-method hashCode בכל אחד שני האובייקטים חייבים להפיק את אותה תוצאה של מספר שלם.
  • לא נדרש שאם שני אובייקטים אינם שווים בהתאם לequals(java.lang.Object) ואז קריאה ל-method hashCode בכל אחד שני אובייקטים חייבים להניב תוצאות נפרדות של מספרים שלמים. אבל, מתכנת צריך להיות מודע לכך שהפקת תוצאות של מספרים שלמים נפרדים לאובייקטים לא שווים, עשויה לשפר את הביצועים של טבלאות גיבוב.

עד כמה שהדבר מעשי באופן סביר, שיטת ה-hashCode מוגדרת לפי מחלקה Object מחזיר מספרים שלמים ייחודיים של אובייקטים ייחודיים. (ייתכן שה-hashCode לא הוטמע בתור פונקציה כלשהי של כתובת הזיכרון של אובייקט בשלב כלשהו בזמן).

החזרות
int הגיבוב (hash) של נתוני האובייקט FetchAndJoinCustomAudienceRequest.

toString (מחרוזת)

public String toString ()

מחזירה ייצוג במחרוזת של האובייקט. באופן כללי, ה-method toString מחזירה מחרוזת 'ייצוג טקסטואלי' של האובייקט הזה. התוצאה צריכה להיות ייצוג תמציתי ואינפורמטיבי, שקל לבצע אדם לקרוא. מומלץ שכל מחלקות המשנה יבטלו את השיטה הזו.

השיטה toString לכיתה Object מחזירה מחרוזת שמורכבת מהשם של המחלקה שבה האובייקט הוא מופע, התו '@' עם הסימן @, את הייצוג ההקסדצימלי הלא חתום של קוד הגיבוב של לאובייקט. במילים אחרות, השיטה הזו מחזירה מחרוזת השווה ערך של: 

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

החזרות
String ייצוג קריא לאנשים של FetchAndJoinCustomAudienceRequest.