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