शेयर किए गए संपर्क के लिए कस्टम विशेषताओं को तय करने के लिए, एक्सटेंडेड प्रॉपर्टी और प्रोजेक्शन का इस्तेमाल करें.
एक्सटेंडेड प्रॉपर्टी
शेयर किए गए संपर्क की जानकारी को एक्सटेंडेड प्रॉपर्टी के तौर पर सेट किया जा सकता है. इसके लिए, शेयर किए गए संपर्क की एंट्री के लिए, नाम और वैल्यू के जोड़े का इस्तेमाल किया जा सकता है. कुंजी को यूनीक बनाए रखना आपकी ज़िम्मेदारी है. एक्सटेंड की गई प्रॉपर्टी की वैल्यू को वैल्यू (ऐरेबट्ररी स्ट्रिंग) या एक्सएमएल ब्लॉब (प्लेन टेक्स्ट) के तौर पर सेव किया जा सकता है. शेयर किए गए हर संपर्क से ज़्यादा से ज़्यादा 10 एक्सटेंडेड प्रॉपर्टी जुड़ी हो सकती हैं. हर एक्सटेंड की गई प्रॉपर्टी का साइज़ कम होना चाहिए. फ़ोटो या रिंगटोन का इस्तेमाल न करें.
उदाहरण
इस उदाहरण में, एक एक्सटेंड की गई प्रॉपर्टी को दिखाया गया है, जिसमें एक कुंजी और एक वैल्यू है:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
इस उदाहरण में, एक्सटेंडेड प्रॉपर्टी को पासकोड और एक्सएमएल ब्लॉब के साथ दिखाया गया है:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</gd:extendedProperty>
अनुमान की वैल्यू
एक्सटेंड की गई प्रॉपर्टी को सीमित तौर पर दिखाने के लिए, प्रोजेक्शन का इस्तेमाल करें. एक्सटेंड की गई प्रॉपर्टी (gd:extendedElement
एलिमेंट) को सिर्फ़ full
या property-KEY
प्रोजेक्शन में सेट करने की अनुमति है.
यहां दी गई टेबल में, प्रोजेक्शन के लिए इस्तेमाल की जा सकने वाली वैल्यू के बारे में बताया गया है:
अनुमान का नाम | ब्यौरा |
---|---|
thin |
कोई gd:extendedProperty एलिमेंट न तो दिखाया जाता है और न ही अपडेट किया जाता है. |
property-KEY |
KEY , एक्सटेंड की गई प्रॉपर्टी (gd:extendedProperty एलिमेंट) की उस कुंजी को दिखाता है जिसे GET अनुरोधों के लिए दिखाया जाता है या जिसे PUT या POST अनुरोध के लिए अपडेट किया जाना चाहिए. अगर अपडेट करने के दौरान, एक्सटेंड की गई प्रॉपर्टी का इस्तेमाल नहीं किया जाता है, तो प्रॉपर्टी मिटा दी जाती है. |
full
| सभी gd:extendedProperty एलिमेंट दिखाए जाते हैं और अपडेट के दौरान सभी एलिमेंट शामिल करने होते हैं. |