FetchAndJoinCustomCustomerRequest

public final class FetchAndJoinCustomAudienceRequest
extends Object

java.lang.Object
↳ android.adservices.customaudience.FetchAndJoinCustomAudiencesRequest

يشير ذلك المصطلح إلى كائن الطلب الذي يتضمّن المَعلمات المطلوبة والاختيارية اللازمة لاسترجاع 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 يتم إرجاع مبلغ true من قِبل y.equals(z)، ثم يجب أن يعرض 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.

الحصول على إشارات عروض أسعار المستخدم

public AdSelectionSignals getUserBiddingSignals ()

يُرجى الرجوع إلى CustomAudience#getUserBiddingSignals() للحصول على التفاصيل.

المرتجعات
AdSelectionSignals إشارات المشتري التي سيتم استهلاكها بواسطة JavaScript الذي قدّمه المشتري عند مشاركة جمهورك في اختيار إعلان معيّن قد تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

تعرض قيمة رمز التجزئة للكائن. هذه الطريقة لصالح جداول التجزئة مثل تلك التي توفرها HashMap

العقد العام لشركة "hashCode" هو:

  • عندما يتم استدعاءها على الكائن نفسه أكثر من مرة أثناء هو تنفيذ تطبيق Java، الطريقة hashCode يجب أن تعرض باستمرار العدد الصحيح نفسه، بدون تقديم أي معلومات يتم تعديل استخدامها في مقارنات equals على الكائن. لا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ واحدة التطبيق إلى عملية تنفيذ أخرى للتطبيق نفسه.
  • إذا كان هناك كائنان متساويان وفقًا لـ equals(Object) ثم استدعاء طريقة hashCode في كل من يجب أن يُنتج الكائنان نفس نتيجة العدد الصحيح.
  • ليس من الضروري أن يكون هناك كائنان غير متساويين بِحَسَبْ equals(java.lang.Object) ثم استدعاء طريقة hashCode في كل يجب أن ينتج عن كائنين نتائج أعداد صحيحة مميزة. ومع ذلك، يجب أن يكون المبرمج على علم بأنّ إنتاج نتائج أعداد صحيحة مميّزة للكائنات غير المتساوية إلى تحسين أداء جداول التجزئة.

بقدر ما يكون عمليًا بشكل معقول، تم تحديد طريقة التجزئة حسب الفئة Object يتم إرجاع أعداد صحيحة مميزة الكائنات المميزة. (قد يتم تنفيذ رمز التجزئة أو لا كدالة معينة لعنوان ذاكرة الكائن عند نقطةٍ ما في الوقت المناسب).

المرتجعات
int تجزئة بيانات عنصر FetchAndJoinCustomAudienceRequest.

إلىسلسلة

public String toString ()

تعرض تمثيلاً سلسلة للكائن. بشكل عام، تُرجع طريقة toString سلسلة "يمثل نصيًا" لهذا الكائن. يجب أن تكون النتيجة أن يكون تمثيلاً موجزًا وغنيًا بالمعلومات ويسهل على الشخص المراد قراءته. من المستحسن أن تتجاهل جميع الفئات الفرعية هذه الطريقة.

استخدام الطريقة toString للفئة Object تُنتج سلسلة تتكون من اسم الفئة التي هو مثيل، فإن حرف علامة @ `@'، التمثيل السداسي العشري غير الموقع لرمز التجزئة الخاص بك. بعبارة أخرى، تُرجع هذه الطريقة سلسلة تساوي قيمة: 

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

المرتجعات
String تمثيل FetchAndJoinCustomAudienceRequest يمكن لشخص عادي قراءته