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

Domain Shared Contacts API, Google Data API के स्टैंडर्ड एलिमेंट और शेयर किए गए संपर्कों के लिए खास तौर पर बनाए गए एलिमेंट का इस्तेमाल करता है.

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

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 से जुड़ी सहायता

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

• 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 नहीं दिखाया जाता जिनमें संपर्क अब शामिल नहीं है.