Class Session

सेशन

सेशन क्लास, सेशन की जानकारी का ऐक्सेस देती है. जैसे, उपयोगकर्ता का ईमेल पता (कुछ मामलों में) और भाषा की सेटिंग.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getActiveUser()Userमौजूदा उपयोगकर्ता के बारे में जानकारी मिलती है.
getActiveUserLocale()Stringमौजूदा उपयोगकर्ता की भाषा की सेटिंग को स्ट्रिंग के तौर पर दिखाता है. उदाहरण के लिए, अंग्रेज़ी के लिए en.
getEffectiveUser()Userउस उपयोगकर्ता के बारे में जानकारी मिलती है जिसके अधिकार से स्क्रिप्ट चल रही है.
getScriptTimeZone()Stringस्क्रिप्ट का टाइम ज़ोन दिखाता है.
getTemporaryActiveUserKey()Stringसक्रिय उपयोगकर्ता को एक ऐसा पासकोड मिलता है जो सिर्फ़ उसके लिए यूनीक होता है. हालांकि, इससे उपयोगकर्ता की पहचान ज़ाहिर नहीं होती.

ज़्यादा जानकारी वाला दस्तावेज़

getActiveUser()

मौजूदा उपयोगकर्ता के बारे में जानकारी मिलती है. अगर सुरक्षा नीतियों से उपयोगकर्ता की पहचान को ऐक्सेस करने की अनुमति नहीं मिलती है, तो User.getEmail() खाली स्ट्रिंग दिखाता है. उपयोगकर्ता का ईमेल पता, अलग-अलग परिस्थितियों में उपलब्ध होता है: उदाहरण के लिए, उपयोगकर्ता का ईमेल पता किसी भी ऐसे कॉन्टेक्स्ट में उपलब्ध नहीं होता जिसमें स्क्रिप्ट को उस उपयोगकर्ता की अनुमति के बिना चलाया जा सकता है. जैसे, कोई सामान्य onOpen(e) या onEdit(e) ट्रिगर, Google Sheets में कोई कस्टम फ़ंक्शन या "मेरे तौर पर चलाएं" के लिए डिप्लॉय किया गया वेब ऐप्लिकेशन (यानी, उपयोगकर्ता के बजाय डेवलपर ने अनुमति दी है). हालांकि, आम तौर पर ये पाबंदियां तब लागू नहीं होतीं, जब डेवलपर खुद स्क्रिप्ट चलाता है या वह उपयोगकर्ता के Google Workspace डोमेन का सदस्य होता है. 

// Log the email address of the person running the script.
const email = Session.getActiveUser().getEmail();
Logger.log(email);

वापसी का टिकट

User — मौजूदा उपयोगकर्ता

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/userinfo.email

getActiveUserLocale()

मौजूदा उपयोगकर्ता की भाषा की सेटिंग को स्ट्रिंग के तौर पर दिखाता है. उदाहरण के लिए, अंग्रेज़ी के लिए en. 

// Log the language setting of the person running the script.
Logger.log(Session.getActiveUserLocale());

वापसी का टिकट

String — उपयोगकर्ता की भाषा की सेटिंग दिखाने वाली स्ट्रिंग

getEffectiveUser()

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

// Log the email address of the user under whose authority the script is
// running.
const email = Session.getEffectiveUser().getEmail();
Logger.log(email);

वापसी का टिकट

User — वह उपयोगकर्ता जिसकी अनुमति से स्क्रिप्ट चल रही है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/userinfo.email

getScriptTimeZone()

स्क्रिप्ट का टाइम ज़ोन दिखाता है. नई स्क्रिप्ट, डिफ़ॉल्ट रूप से मालिक के टाइम ज़ोन में सेट होती हैं. हालांकि, स्क्रिप्ट के टाइम ज़ोन को बदला जा सकता है. इसके लिए, स्क्रिप्ट एडिटर में फ़ाइल > प्रोजेक्ट प्रॉपर्टी पर क्लिक करें. ध्यान दें कि स्प्रेडशीट का टाइम ज़ोन अलग होता है. इसे Google Sheets में फ़ाइल > स्प्रेडशीट सेटिंग पर क्लिक करके बदला जा सकता है. स्प्रेडशीट के टाइम ज़ोन, स्क्रिप्ट के टाइम ज़ोन से अलग होने पर, स्क्रिप्ट में अक्सर गड़बड़ियां होती हैं. 

// Log the time zone of the script.
const timeZone = Session.getScriptTimeZone();
Logger.log(timeZone);

वापसी का टिकट

String — स्क्रिप्ट का टाइम ज़ोन

getTemporaryActiveUserKey()

सक्रिय उपयोगकर्ता को एक ऐसा पासकोड मिलता है जो सिर्फ़ उसके लिए यूनीक होता है. हालांकि, इससे उपयोगकर्ता की पहचान ज़ाहिर नहीं होती. अस्थायी पासकोड हर 30 दिन में बदल जाता है और यह स्क्रिप्ट के हिसाब से अलग-अलग होता है. 

// Log the temporary key of the person running the script.
Logger.log(Session.getTemporaryActiveUserKey());

वापसी का टिकट

String — कुछ समय के लिए सक्रिय उपयोगकर्ता की कुंजी

अब काम न करने वाले तरीके