एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

जवाब: कॉन्सटेंट | कलाकार | तरीके | इनहेरिट किए गए तरीके

विज्ञापन आईडी

public class AdId
extends Object

java.lang.Object
↳	android.adservices.adid.AdId

---

विज्ञापन के लिए यूनीक, उपयोगकर्ता के हिसाब से रीसेट किया जा सकने वाला, डिवाइस के हिसाब से हर प्रोफ़ाइल आईडी.

विज्ञापन नेटवर्क, दिलचस्पी के हिसाब से विज्ञापन (आईबीए) से कमाई करने के लिए AdId का इस्तेमाल कर सकते हैं, यानी टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) और रीमार्केटिंग विज्ञापन. उपयोगकर्ता इस आइडेंटिफ़ायर की उपलब्धता को सीमित कर सकता है.

यह भी देखें:

• AdIdManager.getAdId(Executor, OutcomeReceiver)

खास जानकारी

स्थिरांक
String	ZERO_OUT उपयोगकर्ता के पास limited ad tracking होने पर, ज़ीरो-आउट होने वाला ad id दिखता है.

सार्वजनिक कंस्ट्रक्टर
AdId(String adId, boolean limitAdTrackingEnabled) AdId का इंस्टेंस बनाता है

सार्वजनिक तरीके
boolean	equals(Object o) यह बताता है कि कोई दूसरा ऑब्जेक्ट "इसके बराबर" है या नहीं यह वाला.
String	getAdId() विज्ञापन आईडी.
int	hashCode() यह फ़ंक्शन किसी ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है.
boolean	isLimitAdTrackingEnabled() विज्ञापन ट्रैकिंग की सीमा को चालू करने वाली सेटिंग की जानकारी हासिल करता है.
String	toString() यह फ़ंक्शन ऑब्जेक्ट को स्ट्रिंग के तौर पर दिखाता है.

इनहेरिट किए गए तरीके

क्लास से java.lang.Object Object clone() इस ऑब्जेक्ट की कॉपी बनाता और दिखाता है. boolean equals(Object obj) यह बताता है कि कोई दूसरा ऑब्जेक्ट "इसके बराबर" है या नहीं यह वाला. void finalize() कचरा इकट्ठा करते समय किसी ऑब्जेक्ट पर कूड़ा इकट्ठा करने वाले का कॉल किया जाता है तय करता है कि ऑब्जेक्ट के लिए और रेफ़रंस नहीं हैं. final Class<?> getClass() इस Object की रनटाइम क्लास दिखाता है. int hashCode() यह फ़ंक्शन किसी ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है. final void notify() उस एक थ्रेड को जगाता है जो इस ऑब्जेक्ट के इंतज़ार में है मॉनिटर करें. final void notifyAll() इस ऑब्जेक्ट के मॉनिटर पर इंतज़ार कर रहे सभी थ्रेड को सक्रिय करता है. String toString() यह फ़ंक्शन ऑब्जेक्ट को स्ट्रिंग के तौर पर दिखाता है. final void wait(long timeoutMillis, int nanos) इस वजह से, मौजूदा थ्रेड को आम तौर पर ऐक्टिव होने तक इंतज़ार करना पड़ता है सूचना देकर, बात करके या रीयल टाइम की तय अवधि बीत चुकी है. final void wait(long timeoutMillis) इस वजह से, मौजूदा थ्रेड को आम तौर पर ऐक्टिव होने तक इंतज़ार करना पड़ता है सूचना देकर, बात करके या रीयल टाइम की तय अवधि बीत चुकी है. final void wait() इस वजह से, मौजूदा थ्रेड को आम तौर पर ऐक्टिव होने तक इंतज़ार करना पड़ता है सूचना देकर या बात करके रोका जा सकता है.

स्थिरांक

शून्य

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

public static final String ZERO_OUT

उपयोगकर्ता के पास limited ad tracking होने पर, ज़ीरो-आउट होने वाला ad id दिखता है.

कॉन्स्टेंट वैल्यू: "00000000-0000-0000-0000-000000000000"

सार्वजनिक कंस्ट्रक्टर

विज्ञापन आईडी

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

AdId का इंस्टेंस बनाता है

पैरामीटर
adId	String: सेवा देने वाली कंपनी से मिला. यह मान null नहीं हो सकता.
limitAdTrackingEnabled	boolean: कंपनी सेवा से मिली वैल्यू, जो विज्ञापन आईडी.

सार्वजनिक तरीके

बराबर

एपीआई लेवल 34 में जोड़ा गया

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	true, अगर यह ऑब्जेक्ट, obj जैसा है तर्क; अगर ऐसा नहीं है, तो false.

गेटविज्ञापनआईडी

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

public String getAdId ()

विज्ञापन आईडी.

विज्ञापन आईडी की वैल्यू, isLimitAdTrackingEnabled() और AdServicesPermissions.ACCESS_ADSERVICES_AD_ID के कॉम्बिनेशन के हिसाब से तय होती है.

उपयोगकर्ता के limiting ad tracking होने पर, एपीआई यह वैल्यू दिखाता है ZERO_OUT. इससे कॉलर को कमाई करने के मकसद से उपयोगकर्ता को ट्रैक करने की अनुमति नहीं मिलती है.

ऐसा न होने पर, डिवाइस और उपयोगकर्ता के लिए एक यूनीक स्ट्रिंग दिखती है, जिसका इस्तेमाल ट्रैक करने के लिए किया जा सकता है उपयोगकर्ता भी होते हैं.

रिटर्न
String	यह मान null नहीं हो सकता.

हैशकोड

एपीआई लेवल 34 में जोड़ा गया

public int hashCode ()

यह फ़ंक्शन किसी ऑब्जेक्ट के लिए हैश कोड की वैल्यू दिखाता है. यह तरीका हैश टेबल के फ़ायदे के लिए काम करता है, जैसे कि HashMap.

hashCode का सामान्य अनुबंध यह है:

• जब भी किसी ऑब्जेक्ट को एक ही ऑब्जेक्ट पर एक से ज़्यादा बार शुरू किया जाता है Java ऐप्लिकेशन को एक्ज़ीक्यूट करना, hashCode तरीका बिना कोई जानकारी दिए, लगातार एक ही पूर्णांक दिखाना चाहिए ऑब्जेक्ट की equals तुलनाओं में इस्तेमाल किए गए डेटा में बदलाव किया गया है. इस पूर्णांक को किसी एक लागू करने के लिए उसी ऐप्लिकेशन का इस्तेमाल किया जाएगा.
• अगर equals(Object) के हिसाब से दो ऑब्जेक्ट बराबर हैं इसके बाद, hashCode तरीके को कॉल करके दोनों ऑब्जेक्ट को एक ही पूर्णांक नतीजा देना चाहिए.
• अगर दो ऑब्जेक्ट बराबर नहीं हैं, तो ज़रूरी नहीं है equals(java.lang.Object) के मुताबिक तरीका चुनने के बाद, hashCode तरीके को कॉल करके दो ऑब्जेक्ट होने चाहिए. इनसे अलग-अलग पूर्णांक नतीजे जनरेट होने चाहिए. हालांकि, प्रोग्रामर को यह जानकारी होनी चाहिए कि अलग-अलग पूर्णांक नतीजे तैयार करते समय के लिए, हैश टेबल की परफ़ॉर्मेंस बेहतर हो सकती है.

जितना व्यावहारिक है, उसके लिए हैशकोड विधि को परिभाषित किया गया था श्रेणी Object के अनुसार के लिए अलग-अलग पूर्णांक लौटाता है अलग-अलग ऑब्जेक्ट होने चाहिए. (हैशकोड लागू किया जा सकता है और नहीं भी किसी ऑब्जेक्ट के मेमोरी पते के कुछ फ़ंक्शन के तौर पर समय में.)

रिटर्न
int	इस ऑब्जेक्ट के लिए एक हैश कोड वैल्यू.

islimitAdTrackingEnabled

एपीआई लेवल 34 में जोड़ा गया
विज्ञापन सेवाएं एक्सटेंशन 4 में भी जोड़ा गया

public boolean isLimitAdTrackingEnabled ()

विज्ञापन ट्रैकिंग की सीमा को चालू करने वाली सेटिंग की जानकारी हासिल करता है.

अगर उपयोगकर्ता ने विज्ञापन ट्रैकिंग की सीमा तय की है, तो यह मान सही है, नहीं तो false.

रिटर्न
boolean

टूस्ट्रिंग

एपीआई लेवल 34 में जोड़ा गया

public String toString ()

यह फ़ंक्शन ऑब्जेक्ट को स्ट्रिंग के तौर पर दिखाता है. सामान्य तौर पर, toString तरीका ऐसा स्ट्रिंग दिखाता है जो "टेक्स्ट के तौर पर दिखाता है" सबमिट करें. इसका नतीजा यह होना चाहिए: संक्षिप्त लेकिन जानकारी देने वाला होना चाहिए, जो कोई व्यक्ति चुनें. हमारा सुझाव है कि सभी सब-क्लास इस तरीके को बदल दें.

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

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

रिटर्न
String	ऑब्जेक्ट को स्ट्रिंग के तौर पर दिखाना.