FetchAndJoinCustomUrlRequest
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
أداة إنشاء لـ |
الطرق المتاحة للجميع | |
---|---|
boolean
|
equals(Object o)
يشير إلى ما إذا كان هناك كائن آخر "يساوي" هذا الكائن. |
Instant
|
getActivationTime()
لمزيد من التفاصيل، يُرجى الرجوع إلى |
Instant
|
getExpirationTime()
لمزيد من التفاصيل، يُرجى الرجوع إلى |
Uri
|
getFetchUri()
|
String
|
getName()
لمزيد من التفاصيل، يُرجى الرجوع إلى |
AdSelectionSignals
|
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
، تعرض هذه الطريقة true
إذا كان x
وy
يشيران إلى الكائن نفسه فقط (وتكون قيمة x == y
هي true
).
يُرجى العِلم أنّه من الضروري عمومًا إلغاء الطريقة hashCode
كلما تم تجاوز هذه الطريقة، وذلك للحفاظ على
العقد العام للطريقة hashCode
التي تنص على
أنّ العناصر المتساوية يجب أن تحتوي على رموز تجزئة متساوية.
المعلّمات | |
---|---|
o |
Object : الكائن المرجعي المطلوب مقارنته. |
الركلات المردودة | |
---|---|
boolean |
true فقط إذا كان عنصران FetchAndJoinCustomAudienceRequest يحتويان على المعلومات نفسها. |
وقت التفعيل
public Instant getActivationTime ()
لمزيد من التفاصيل، يُرجى الرجوع إلى CustomAudience#getActivationTime()
.
الركلات المردودة | |
---|---|
Instant |
Instant الذي سيتأخر عنده الانضمام إلى الجمهور المخصّص.
قد تكون هذه القيمة null . |
الحصول على وقت انتهاء الصلاحية
public Instant getExpirationTime ()
لمزيد من التفاصيل، يُرجى الرجوع إلى CustomAudience#getExpirationTime()
.
الركلات المردودة | |
---|---|
Instant |
Instant بحلول وقت انتهاء صلاحية العضوية في الجمهور المخصّص.
قد تكون هذه القيمة null . |
أمر getFetchUri
public Uri getFetchUri ()
الركلات المردودة | |
---|---|
Uri |
Uri التي سيتم جلب الجمهور المخصّص منها.
لا يمكن أن تكون هذه القيمة null . |
الحصول على الاسم
public String getName ()
لمزيد من التفاصيل، يُرجى الرجوع إلى CustomAudience#getName()
.
الركلات المردودة | |
---|---|
String |
اسم String للجمهور المخصّص المطلوب الانضمام إليه.
قد تكون هذه القيمة null . |
الحصول على معلومات عروض أسعار "عروض أسعار Google"
public AdSelectionSignals getUserBiddingSignals ()
لمزيد من التفاصيل، يُرجى الرجوع إلى CustomAudience#getUserBiddingSignals()
.
الركلات المردودة | |
---|---|
AdSelectionSignals |
يشير المشتري إلى أن يطبّقه رمز JavaScript الذي يقدّمه المشتري عندما يشارك
الجمهور المخصّص في اختيار إعلان.
قد تكون هذه القيمة null . |
رمز التجزئة
public int hashCode ()
لعرض قيمة رمز تجزئة للكائن. يمكن استخدام هذه الطريقة للاستفادة من جداول التجزئة، مثل الجداول التي توفّرها السمة HashMap
.
العقد العام لشركة "hashCode
" هو:
- عند استدعائها في الكائن نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن تعرض طريقة
hashCode
العدد الصحيح نفسه بشكل مستمر، شرط عدم تعديل أي معلومات مستخدَمة في مقارناتequals
مع الكائن. ولا يلزم أن يظل هذا العدد الصحيح متسقًا من عملية تنفيذ للتطبيق نفسه إلى أخرى. - إذا كان هناك كائنان متساويان وفق الطريقة
equals(Object)
، يجب أن يؤدي استدعاء الطريقةhashCode
على كل عنصر إلى النتيجة الصحيحة نفسها. - ليس من الضروري أن يؤدي استدعاء الطريقة
hashCode
على كل كائن إلى الحصول على نتائج عدد صحيح مختلفة، وذلك في حال كان كائنان غير متساويَين وفقًا للطريقةequals(java.lang.Object)
. ومع ذلك، يجب أن يدرك المبرمجون أنّ توفير نتائج عدد صحيح مميّز للكائنات غير المتكافئة قد يؤدي إلى تحسين أداء جداول التجزئة.
بقدر ما هي عملية معقولة، فإنّ طريقة valueCode المحدّدة في الفئة Object
تعرض أعدادًا صحيحة مختلفة للكائنات المختلفة. (قد يتم في وقت ما تنفيذ رمز التجزئة
أو لا يتم تنفيذه كأحد وظائف عنوان ذاكرة العنصر).
الركلات المردودة | |
---|---|
int |
تجزئة بيانات الكائن FetchAndJoinCustomAudienceRequest . |
سلسلة
public String toString ()
لعرض تمثيل سلسلة للكائن. وبشكل عام، تعرض الطريقة toString
سلسلة "تمثل نصيًا" لهذا الكائن. ويجب أن تكون النتيجة عبارة عن وصف موجز وغني بالمعلومات يسهل على المستخدم قراءته.
من المستحسن أن تلغي جميع الفئات الفرعية هذه الطريقة.
تعرض الطريقة toString
للفئة Object
سلسلة تتكون من اسم الفئة التي يكون الكائن فيها مثيلاً، وحرف العلامة "@
"، والتمثيل السداسي العشري غير الموقَّع لرمز تجزئة
الكائن. بمعنى آخر، تُرجع هذه الطريقة سلسلة تساوي قيمة:
getClass().getName() + '@' + Integer.toHexString(hashCode())
الركلات المردودة | |
---|---|
String |
تمثيل FetchAndJoinCustomAudienceRequest يمكن لشخص عادي قراءته. |