शेयर किए गए संपर्क एलिमेंट

डोमेन के शेयर किए गए संपर्कों का एपीआई, स्टैंडर्ड Google Data API एलिमेंट और शेयर किए गए संपर्कों के लिए खास एलिमेंट का इस्तेमाल करता है.

संपर्क की जानकारी, संपर्क का टाइप के तौर पर दी जाती है. इसमें किसी व्यक्ति, क्लब या रेस्टोरेंट जैसी जगह या किसी संगठन की जानकारी शामिल होती है. संपर्क का टाइप, एक्सएमएल में <atom:entry> एलिमेंट के तौर पर दिखता है. इसमें Google डेटा नेमस्पेस के अलग-अलग एक्सटेंशन एलिमेंट होते हैं.

category एलिमेंट से पता चलता है कि एंट्री संपर्क है. यह एलिमेंट इस तरह दिखता है:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Domain Shared Contacts API में, कई एलिमेंट संपर्क के टाइप की तुलना में थोड़े ज़्यादा पाबंदी वाले होते हैं. यहां दिए गए एलिमेंट के लिए, rel एट्रिब्यूट या label एट्रिब्यूट में से किसी एक की वैल्यू सबमिट करें, दोनों की नहीं:

• gd:email
• gd:im
• gd:organization
• gd:phoneNumber
• gd:structuredPostalAddress

शेयर किया गया संपर्क बनाते या अपडेट करते समय, अगर आपने rel और label, दोनों एलिमेंट की वैल्यू दी है या इनमें से किसी भी एलिमेंट की वैल्यू नहीं दी है, तो सर्वर उस एंट्री को अस्वीकार कर देता है.

Photos सहायता

स्टैंडर्ड प्रॉपर्टी की वैल्यू, जैसे कि self या edit के साथ-साथ, atom:link एलिमेंट के लिए rel वैल्यू का इस्तेमाल किया जा सकता है. फ़ोटो के लिंक इस्तेमाल करते समय, एचटीटीपी हेडर में अनुमति टोकन की जानकारी देनी होगी. ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

• GET कमांड की मदद से, rel="http://schemas.google.com/contacts/2008/rel#photo", संपर्क से जुड़ी फ़ोटो को पढ़ने की सुविधा जोड़ता है. href में दिए गए यूआरएल का इस्तेमाल करके, संपर्क से जुड़ी फ़ोटो का नया वर्शन पढ़ा जा सकता है. अगर संपर्क की कोई फ़ोटो नहीं है, तो लिंक नहीं दिखता.

उदाहरण:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />

• PUT या DELETE कमांड के साथ, rel="http://schemas.google.com/contacts/2008/rel#edit-photo", संपर्क से जुड़ी किसी स्थानीय फ़ोटो को अपडेट करने या मिटाने की सुविधा जोड़ता है.

उदाहरण:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContact नेमस्पेस

gContact के लिए एक्सएमएल नेमस्पेस का यूआरएल http://schemas.google.com/contact/2008 है.

इस नेमस्पेस में, एक एलिमेंट तय किया गया है, जो उस ग्रुप को दिखाता है जिससे संपर्क जुड़ा है.

gContact:groupMembershipInfo प्रॉपर्टी

प्रॉपर्टी	ब्यौरा
href	उस ग्रुप की पहचान करता है जिससे संपर्क जुड़ा है या जुड़ा था. ग्रुप का रेफ़रंस, उसके आईडी से दिया जाता है.
deleted="true"	इसका मतलब है कि संपर्क की ग्रुप की सदस्यता हटा दी गई है. यह एट्रिब्यूट सिर्फ़ तब शामिल किया जाता है, जब showdeleted को क्वेरी पैरामीटर के तौर पर तय किया गया हो. ऐसा न होने पर, उन ग्रुप के लिए groupMembershipInfo नहीं दिखाया जाता जिनसे कोई संपर्क अब नहीं जुड़ा है.