परिचय

लोगों API से आप ये काम कर सकते हैं:

  • पुष्टि किए गए उपयोगकर्ता के संपर्क पढ़ें और मैनेज करें
  • पुष्टि किए गए उपयोगकर्ता के "अन्य संपर्क" को पढ़ें और कॉपी करें
  • पुष्टि किए गए उपयोगकर्ताओं और उनके संपर्कों की प्रोफ़ाइल की जानकारी पढ़ें
  • डोमेन प्रोफ़ाइल और संपर्क पढ़ें

उदाहरण के लिए, मान लीजिए कि पुष्टि किए गए उपयोगकर्ता जेन के निजी संपर्कों में फ़ैबियन और रंजीत हैं. जब आपका ऐप्लिकेशन people.connections.list को अपने कनेक्शन की सूची पढ़ने के लिए कॉल करता है, तो जेन को सहमति वाली स्क्रीन दिखती है. इसमें, ऐप्लिकेशन से सूची का ऐक्सेस मांगा जाता है. अगर जेन की सहमति मिलती है, तो ऐप्लिकेशन एक सूची पढ़ता है, जिसमें फ़ैबियन और रंजीत के लिए person resources होता है.

अगर ऐप्लिकेशन को किसी खास व्यक्ति की जानकारी की ज़रूरत है, तो वह people.get को कॉल कर सकता है और संसाधन का नाम पास करके, उस व्यक्ति के लिए person resource पा सकता है.

यह ऐप्लिकेशन people.createContact का इस्तेमाल करके नए संपर्क बनाकर भी संपर्कों को मैनेज कर सकता है. people.connections.list ने जिन मौजूदा संपर्कों को पढ़ा है उन्हें people.updateContact का इस्तेमाल करके अपडेट किया जा सकता है और people.deleteContact का इस्तेमाल करके संपर्कों को मिटाया जा सकता है.

Google Workspace के उपयोगकर्ता, people.listDirectoryPeople का इस्तेमाल करके अपनी डायरेक्ट्री के डोमेन प्रोफ़ाइलों और डोमेन संपर्कों की सूची बना सकते हैं या people.searchDirectoryPeople का इस्तेमाल करके उन्हें खोज सकते हैं.

लोगों की जानकारी का मर्ज किया गया व्यू

लोगों की जिस जानकारी को लोगों का एपीआई पढ़ता है उसे अलग-अलग सोर्स से मर्ज कर दिया जाता है. यह इन स्थितियों के आधार पर तय होता है:

सोर्स शर्त
सार्वजनिक Google प्रोफ़ाइल डेटा हमेशा पर टैप करें.
Google Workspace डोमेन प्रोफ़ाइल का डेटा डोमेन एडमिन ने डोमेन के स्कोप वाले डेटा के लिए, संगठन से बाहर संपर्क और प्रोफ़ाइल शेयर करने की सुविधा चालू कर दी है. साथ ही, directory.readonly का दायरा दिया गया है
पुष्टि किए गए उपयोगकर्ता की निजी प्रोफ़ाइल जानकारी इनमें से एक profileस्कोप को स्वीकार कर लिया गया है.
पुष्टि किए गए उपयोगकर्ता के संपर्क contacts दायरा अनुमति दे दी गई है.

मर्ज किए गए व्यक्ति के डेटा को समझना

किसी व्यक्ति का डेटा मुख्य सोर्स टाइप से लिया जाता है. अगर सोर्स, पुष्टि किए गए ईमेल पतों, फ़ोन नंबर या प्रोफ़ाइल यूआरएल से कनेक्ट किए जाते हैं, तो अन्य सोर्स के डेटा को इस डेटा के साथ मर्ज कर दिया जाता है. किसी व्यक्ति के बारे में इस तरह से लिखा जा सकता है:

मुख्य स्रोत संपर्क प्रोफ़ाइलें Google Workspace डोमेन प्रोफ़ाइलें Google Workspace के डोमेन संपर्क इस्तेमाल का तरीका
Contact 1 0+ 0+ 0+ ज़्यादातर एंडपॉइंट के लिए, यूआरएल वापस किए जाते हैं
प्रोफ़ाइल 0+ 1 0 या 1 0 people.get में तब लौटाए जाते हैं, जब इसका इस्तेमाल साइन इन किए हुए उपयोगकर्ता के लिए या किसी व्यक्ति को दूसरे उपयोगकर्ता के Google खाते पर पाने के लिए किया जाता है.
डोमेन संपर्क 0+ 0 0 1 people.listDirectoryPeople या people.searchDirectoryPeople में लौटाया गया.

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