लोग API आपको यह करने देता है:
- पुष्टि किए गए उपयोगकर्ता के संपर्क पढ़ें और प्रबंधित करें
- पुष्टि किए गए उपयोगकर्ता के "दूसरे संपर्क" लेख को पढ़ना और कॉपी करना
- पुष्टि किए गए उपयोगकर्ताओं और उनके संपर्कों की प्रोफ़ाइल की जानकारी पढ़ें
- डोमेन की प्रोफ़ाइलें और संपर्क पढ़ें
उदाहरण के लिए, मान लें कि पुष्टि की गई उपयोगकर्ता, जेन के पास अपने निजी संपर्कों में
फ़ैबियन और रंजीत हैं. जब आपका ऐप्लिकेशन people.connections.list को अपने कनेक्शन की सूची पढ़ने के लिए कॉल करता है, तो जेन को एक स्क्रीन दिखती है. इसमें, ऐप्लिकेशन को सूची का ऐक्सेस देने के लिए कहा जाता है. अगर जेन सहमति देती हैं, तो ऐप्लिकेशन एक सूची पढ़ता है, जिसमें फ़ैबियन और रंजीत के लिए person resources होता है.
अगर ऐप्लिकेशन को किसी खास व्यक्ति की जानकारी की ज़रूरत है, तो वह रिसॉर्स का नाम पास करके
people.get को कॉल कर सकता है, ताकि उस व्यक्ति को person resource मिल सके.
ऐप्लिकेशन people.createContact का इस्तेमाल करके नए संपर्क बनाकर, संपर्कों को मैनेज कर सकता है. साथ ही, संपर्क संपर्कों को अपडेट कर सकता है, जिन्हें people.updateContact का इस्तेमाल करके people.connections.list से पढ़ा गया है. साथ ही, people.deleteContact का इस्तेमाल करके संपर्कों को मिटाया जा सकता है.
Google Workspace के उपयोगकर्ता people.listDirectoryPeople का इस्तेमाल करके, डायरेक्ट्री डोमेन प्रोफ़ाइल और डोमेन संपर्क की सूची बना सकते हैं या people.searchDirectoryPeople का इस्तेमाल करके उन्हें खोज सकते हैं.
लोगों की जानकारी को मिलाकर एक बनाया गया व्यू
नीचे दी गई स्थितियों के आधार पर, लोग एपीआई जानकारी को अलग-अलग सोर्स से मर्ज करते हैं:
| सोर्स | शर्त |
|---|---|
| सार्वजनिक Google प्रोफ़ाइल डेटा | हमेशा पर टैप करें. |
| Google Workspace डोमेन प्रोफ़ाइल का डेटा | डोमेन के एडमिन ने डोमेन के दायरे वाले डेटा में, बाहरी संपर्क और प्रोफ़ाइल शेयर करने की सुविधा
चालू कर दी है. साथ ही,
directory.readonly
दायरे में अनुमति दे दी गई है |
| पुष्टि किए गए उपयोगकर्ता की निजी प्रोफ़ाइल की जानकारी | कोई एक profile
दायरा
दिया गया है. |
| पुष्टि किए गए उपयोगकर्ता की संपर्क जानकारी | contacts
दायरे की अनुमति दे दी गई है. |
मर्ज किए गए व्यक्ति के डेटा को समझना
किसी व्यक्ति का डेटा एक मुख्य सोर्स टाइप से लिया जाता है. अगर सोर्स, पुष्टि किए गए ईमेल पतों, फ़ोन नंबर या प्रोफ़ाइल यूआरएल के ज़रिए कनेक्ट हैं, तो अन्य सोर्स से मिले डेटा को इस डेटा के साथ मर्ज कर दिया जाता है. इन तरीकों से, किसी व्यक्ति को बनाया जा सकता है:
| मुख्य स्रोत | संपर्क | प्रोफ़ाइल | Google Workspace डोमेन प्रोफ़ाइल | Google Workspace डोमेन के संपर्क | इस्तेमाल का तरीका |
|---|---|---|---|---|---|
| संपर्क | 1 | 0+ | 0+ | 0+ | ज़्यादातर एंडपॉइंट के लिए लौटाया गया |
| प्रोफ़ाइल | 0+ | 1 | 0 या 1 | 0 | जब साइन इन किए गए उपयोगकर्ता के लिए उपलब्ध कराया गया हो या किसी अन्य उपयोगकर्ता के के Google खाते का इस्तेमाल किया जा रहा हो, तब people.get को दिखाया जाता है. |
| डोमेन संपर्क | 0+ | 0 | 0 | 1 | people.listDirectoryPeople या people.searchDirectoryPeople में लौटाया गया. |
म्यूट किए गए एंडपॉइंट से, सिर्फ़ उन लोगों को बदला जा सकता है जो संपर्क पर आधारित हैं. प्रोफ़ाइल और डोमेन संपर्क म्यूटेशन समर्थित नहीं हैं.