उपयोगकर्ता की पहचान प्रॉपर्टी को ऐक्सेस करें

उपयोगकर्ता अपने डेटा सोर्स बनाने के लिए, आपके कम्यूनिटी कनेक्टर का इस्तेमाल करेंगे. इन डेटा सोर्स के लिए, आपका कनेक्टर असरदार उपयोगकर्ता की पहचान ऐक्सेस कर सकता है. डेटा सोर्स के क्रेडेंशियल के आधार पर, असरदार उपयोगकर्ता डेटा सोर्स क्रिएटर (मालिक के क्रेडेंशियल) या रिपोर्ट व्यूअर (व्यूअर के क्रेडेंशियल) हो सकता है.

फ़ायदे

• आपके पास उपयोगकर्ता की ओर से, Google की सेवाओं और एपीआई को ऐक्सेस करने का विकल्प है.
• कस्टम ऐक्सेस कंट्रोल लागू करके, यह पक्का किया जा सकता है कि सिर्फ़ काम का डेटा दिखेगा.
• असरदार उपयोगकर्ता के लिए, उपयोगकर्ता अनुभव को अपनी पसंद के मुताबिक बनाया जा सकता है.

लागू करने के चरण

उपयोगकर्ता OAuth टोकन ऐक्सेस करना

आपका कनेक्टर, उपयोगकर्ता के OAuth टोकन को पास करके, उपयोगकर्ता की ओर से Google की सेवाओं और एपीआई को ऐक्सेस कर सकता है. अपने कनेक्टर में असरदार उपयोगकर्ता का OAuth टोकन ऐक्सेस करने के लिए, ScriptApp.getOAuthToken() का इस्तेमाल करें. getOAuthToken रेफ़रंस देखें. इस टोकन में, कनेक्टर को मिली अनुमति के दौरान शामिल किए गए अनुमति देने के दायरे शामिल होंगे.

ज़्यादातर कनेक्टर के लिए, Apps Script अपने-आप पता लगाता है कि स्क्रिप्ट को पार्स और प्रोसेस करके, किन दायरों की ज़रूरत है. किसी भी समय, कनेक्टर के इस्तेमाल किए जाने वाले स्कोप देखे जा सकते हैं. यूआरएल स्ट्रिंग का इस्तेमाल करके, मेनिफ़ेस्ट में खास तौर पर स्कोप सेट भी किया जा सकता है. अगर आपको उपयोगकर्ता की ओर से, Google की किसी सेवा या एपीआई को ऐक्सेस करना है, तो मेनिफ़ेस्ट में उस सेवा या एपीआई को शामिल करें.

उपयोगकर्ता के ईमेल पते को ऐक्सेस करना

अपने कोड में, Session.getEffectiveUser().getEmail() की मदद से, मौजूदा असरदार उपयोगकर्ता की पहचान की जा सकती है. geteffectiveUser रेफ़रंस देखें. इस कोड को जोड़ने से, आपके कनेक्टर में https://www.googleapis.com/auth/userinfo.email की अनुमति का स्कोप अपने-आप जुड़ जाएगा.

उदाहरण: उपयोगकर्ता OAuth टोकन की मदद से Google API को कॉल करना

• Google Fit कनेक्टर, असरदार उपयोगकर्ता के लिए Google Fit API से डेटा लेता है. एपीआई को कॉल करते समय, यह असरदार उपयोगकर्ता का OAuth टोकन पास करता है. लागू करने की जानकारी के लिए सोर्स कोड देखें.
• फ़ायरस्टोर कनेक्टर, क्लाउड रिसॉर्स मैनेजर का इस्तेमाल करके, असरदार उपयोगकर्ता के लिए प्रोजेक्ट की सूची बनाता है. यह कनेक्टर, उपयोगकर्ता का OAuth टोकन भी पास करता है. लागू करने से जुड़ी जानकारी के लिए सोर्स कोड देखें.

उदाहरण: ईमेल पते के आधार पर isAdminUser()

• Chrome UX कनेक्टर में, खाते के एडमिन की सूची मौजूद होती है. यह getEffectiveUser() का इस्तेमाल करके, असरदार उपयोगकर्ता की सूची की तुलना करके यह तय करता है कि असरदार उपयोगकर्ता, एडमिन है या नहीं. getEffectiveUser को लागू करने का तरीका देखें.