बढ़ाई गई प्रॉपर्टी और अनुमान

शेयर किए गए संपर्क के लिए कस्टम विशेषताएं तय करने के लिए, एक्सटेंडेड प्रॉपर्टी और प्रोजेक्शन का इस्तेमाल करें.

एक्सटेंडेड प्रॉपर्टी

शेयर किए गए संपर्क की एंट्री के लिए, शेयर किए गए संपर्क से जुड़ी अतिरिक्त जानकारी को एक्सटेंडेड प्रॉपर्टी के तौर पर सेट किया जा सकता है. इसके लिए, नाम और वैल्यू के जोड़े का इस्तेमाल किया जाता है. कुंजी को यूनीक बनाए रखना आपकी ज़िम्मेदारी है. एक्सटेंड की गई प्रॉपर्टी की वैल्यू को वैल्यू (कोई भी स्ट्रिंग) या XML ब्लोब (सामान्य टेक्स्ट) के तौर पर सेव किया जा सकता है. शेयर किए गए हर संपर्क से ज़्यादा से ज़्यादा 10 एक्सटेंडेड प्रॉपर्टी जुड़ी हो सकती हैं. हर एक्सटेंडेड प्रॉपर्टी का साइज़ छोटा होना चाहिए. फ़ोटो या रिंगटोन का इस्तेमाल न करें.

उदाहरण

यहां दिए गए उदाहरण में, एक एक्सटेंडेड प्रॉपर्टी दिखाई गई है. इसमें एक कुंजी और एक वैल्यू है:

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

इस उदाहरण में, एक्सटेंडेड प्रॉपर्टी को कुंजी और एक्सएमएल ब्लॉब के साथ दिखाया गया है:

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

प्रोजेक्शन वैल्यू

एक्सटेंड की गई प्रॉपर्टी की विज़िबिलिटी को सीमित करने के लिए, प्रोजेक्शन का इस्तेमाल करें. एक्सटेंड की गई प्रॉपर्टी (gd:extendedElement एलिमेंट) को सिर्फ़ full या property-KEY प्रोजेक्शन में सेट किया जा सकता है.

यहां दी गई टेबल में, प्रोजेक्शन की उन वैल्यू के बारे में बताया गया है जिनका इस्तेमाल किया जा सकता है:

अनुमान का नाम ब्यौरा
thin कोई भी gd:extendedProperty एलिमेंट नहीं दिखाया जाता या अपडेट नहीं किया जाता.
property-KEY KEY, एक्सटेंड की गई प्रॉपर्टी (gd:extendedProperty एलिमेंट) की कुंजी दिखाता है. यह कुंजी, GET अनुरोधों के लिए वापस भेजी जाती है या PUT या POST अनुरोध के लिए अपडेट की जानी चाहिए. अगर अपडेट करने के दौरान एक्सटेंड की गई प्रॉपर्टी का इस्तेमाल नहीं किया जाता है, तो प्रॉपर्टी मिटा दी जाती है.
full सभी gd:extendedProperty एलिमेंट वापस कर दिए जाते हैं. साथ ही, अपडेट के दौरान सभी एलिमेंट शामिल किए जाने चाहिए.