डोमेन से शेयर किए गए संपर्क API के बारे में खास जानकारी

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 घंटे लग सकते हैं.

डोमेन शेयर किए गए संपर्क एपीआई की क्षमताओं के बारे में जानकारी देने के अलावा, इस दस्तावेज़ में एक्सएमएल और एचटीटीपी का इस्तेमाल करके, संपर्कों को मैनेज करने के तरीके के बारे में उदाहरण दिए गए हैं. इस दस्तावेज़ को पढ़ने के बाद, हमारी क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई के साथ इंटरैक्ट करने के बारे में ज़्यादा जानकारी पाई जा सकती है.

ऑडियंस

यह दस्तावेज़ उन डेवलपर के लिए है जो ऐसे क्लाइंट ऐप्लिकेशन लिखना चाहते हैं जो एचटीटीपी और एक्सएमएल का इस्तेमाल करके, Google की संपर्क सूचियों में बदलाव कर सकें. इस दस्तावेज़ में यह माना गया है कि आपको Google Data API प्रोटोकॉल की बुनियादी बातें पता हैं.

अगर आप UNIX ऑपरेटिंग सिस्टम का इस्तेमाल कर रहे हैं और आपको बिना कोई कोड लिखे इस दस्तावेज़ में दिए गए उदाहरणों को आज़माना है, तो UNIX कमांड-लाइन यूटिलिटी curl या wget का इस्तेमाल करें. Google डेटा सेवाओं के साथ cURL इस्तेमाल करने का तरीका जानें.

सिद्धांत

Domain Shared Contacts API का यह वर्शन Google Data API के नियमों का पालन करता है. Google Data API, ऐटम पब्लिशिंग प्रोटोकॉल के अलावा ऐटम 1.0 और आरएसएस 2.0 सिंडिकेशन फ़ॉर्मैट, दोनों पर आधारित होते हैं.

कोई वर्शन चुनें

Domain Shared Contacts API का इस्तेमाल करके भेजे जाने वाले हर अनुरोध में, एपीआई का वर्शन 3.0 बताया जाना चाहिए:

GData-Version: 3.0

अगर एचटीटीपी हेडर सेट नहीं किए जा सकते, तो यूआरएल में v=3.0 को क्वेरी पैरामीटर के तौर पर बताया जा सकता है. हालांकि, हमारा सुझाव है कि आप एचटीटीपी हेडर वाले तरीके का इस्तेमाल करें.