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

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

खुद या बदलाव करने जैसी स्टैंडर्ड प्रॉपर्टी की वैल्यू के साथ, 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 नहीं दिखाया जाता है जिनसे कोई संपर्क नहीं जुड़ा है.