फे़चऔरजॉइन कस्टम ऑडियंसअनुरोध

public final class FetchAndJoinCustomAudienceRequest
extends Object

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

अनुरोध के ऑब्जेक्ट में, CustomAudience फ़ेच करने के लिए ज़रूरी और वैकल्पिक पैरामीटर शामिल होते हैं.

सिर्फ़ fetchUri पैरामीटर होना ज़रूरी है. यह से दर्शक. 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 लौटाना चाहिए.

Object क्लास के लिए equals तरीका लागू किया जाता है मिलती-जुलती चीज़ों में जितना ज़्यादा अंतर हो; इसका मतलब है कि उन रेफ़रंस वैल्यू के लिए जो शून्य नहीं हैं x और y, यह तरीका true रिटर्न करता है, अगर सिर्फ़ और सिर्फ़ अगर x और y एक ही ऑब्जेक्ट को रेफ़र करते हैं (x == y का मान true है).

ध्यान दें कि आम तौर पर, hashCode को बदलना ज़रूरी होता है जब इस विधि को बदला जाए, ताकि hashCode तरीके के लिए सामान्य कानूनी समझौता, जिसमें शामिल है कि एक जैसी चीज़ों के हैश कोड एक जैसे होने चाहिए.

पैरामीटर
o Object: वह रेफ़रंस ऑब्जेक्ट जिससे तुलना करनी है.
रिटर्न
boolean अगर दो FetchAndJoinCustomAudienceRequest ऑब्जेक्ट में ये शामिल हों, तो सिर्फ़ true कुछ भी न कर सकें.

'ऐक्टिवेशन टाइम'

public Instant getActivationTime ()

ज़्यादा जानकारी के लिए, CustomAudience#getActivationTime() देखें.

रिटर्न
Instant Instant, जिसके ज़रिए कस्टम ऑडियंस से जुड़ने में देरी होगी. यह वैल्यू null हो सकती है.

'समयसीमा खत्म होने का समय'

public Instant getExpirationTime ()

ज़्यादा जानकारी के लिए, CustomAudience#getExpirationTime() देखें.

रिटर्न
Instant Instant तक, पसंद के मुताबिक ऑडियंस के लिए ली गई सदस्यता खत्म होने वाली है. यह वैल्यू null हो सकती है.

फ़ेचयूरी

public Uri getFetchUri ()

रिटर्न
Uri वह Uri जिससे कस्टम ऑडियंस फ़ेच की जानी है. यह मान null नहीं हो सकता.

गेटनाम

public String getName ()

ज़्यादा जानकारी के लिए, CustomAudience#getName() देखें.

रिटर्न
String शामिल होने के लिए, कस्टम ऑडियंस का String नाम. यह वैल्यू null हो सकती है.

getUser-बिडिंग सिग्नल

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 तरीका ऐसा स्ट्रिंग दिखाता है जो "टेक्स्ट के तौर पर दिखाता है" सबमिट करें. इसका नतीजा यह होना चाहिए: संक्षिप्त लेकिन जानकारी देने वाला होना चाहिए, जो कोई व्यक्ति चुनें. हमारा सुझाव है कि सभी सब-क्लास इस तरीके को बदल दें.

Object क्लास के लिए toString तरीका उस क्लास के नाम वाली स्ट्रिंग देता है जिसकी क्लास ऑब्जेक्ट एक इंस्टेंस है, चिह्न में मौजूद वर्ण `@', और हैश कोड का बिना हस्ताक्षर वाला हेक्साडेसिमल निरूपण ऑब्जेक्ट है. दूसरे शब्दों में, यह तरीका मान: 

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

रिटर्न
String FetchAndJoinCustomAudienceRequest का एक ऐसा फ़ॉर्मैट जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.