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