Domain Shared Contacts API की मदद से, ऐप्लिकेशन को Google Workspace डोमेन में मौजूद सभी उपयोगकर्ताओं के साथ शेयर किए गए बाहरी संपर्कों की जानकारी मिलती है. साथ ही, वे उन्हें अपडेट कर पाते हैं. शेयर किए गए संपर्क, Google Workspace डोमेन के सभी उपयोगकर्ताओं को दिखते हैं. साथ ही, Google की सभी सेवाओं के पास संपर्क सूची का ऐक्सेस होता है.
Domain Shared Contacts API का इस्तेमाल करके, शेयर किए गए संपर्क बनाएं, उनमें बदलाव करें या उन्हें मिटाएं. साथ ही, खास शर्तों को पूरा करने वाले संपर्कों के लिए क्वेरी करें.
Domain Shared Contacts API, सिर्फ़ Google Workspace खातों के लिए उपलब्ध है. एपीआई का इस्तेमाल करने के लिए, Admin console में Domain Shared Contacts API चालू करें. ऑटोमैटिक तरीके से पूरा होने वाले फ़ॉर्म और संपर्क मैनेजर में बदलाव दिखने में 24 घंटे लग सकते हैं.
इस दस्तावेज़ में, Domain Shared Contacts API के बारे में जानकारी दी गई है. साथ ही, एक्सएमएल और एचटीटीपी का इस्तेमाल करके संपर्कों को मैनेज करने के उदाहरण दिए गए हैं. ज़्यादा जानने के लिए, क्लाइंट लाइब्रेरी देखें.
ऑडियंस
यह दस्तावेज़ उन डेवलपर के लिए है जो ऐसे क्लाइंट ऐप्लिकेशन लिखते हैं जो HTTP और XML का इस्तेमाल करके, Google की संपर्क सूचियों में बदलाव करते हैं. इसके लिए, Google Data APIs प्रोटोकॉल के बारे में जानकारी होना ज़रूरी है.
Linux और macOS का इस्तेमाल करने वाले लोग, इस दस्तावेज़ में दिए गए उदाहरणों को curl या wget का इस्तेमाल करके आज़मा सकते हैं. Google Data API के साथ curl का इस्तेमाल करना लेख पढ़ें.
सिद्धांत
Domain Shared Contacts API, Google Data APIs के सिद्धांतों का पालन करता है. Google Data API, Atom 1.0, RSS 2.0, और Atom Publishing Protocol पर आधारित हैं.
कोई वर्शन तय करना
Domain Shared Contacts API का इस्तेमाल करके भेजे गए सभी अनुरोधों में, वर्शन 3.0 के बारे में जानकारी होनी चाहिए:
GData-Version: 3.0
अगर एचटीटीपी हेडर सेट नहीं किए जा सकते, तो v=3.0 को क्वेरी पैरामीटर के तौर पर सेट करें.
हमारा सुझाव है कि एचटीटीपी हेडर का इस्तेमाल करें.