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.
var 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.
var 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.
var timeZone = Session.getScriptTimeZone();
Logger.log(timeZone);

रिटर्न

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


getTemporaryActiveUserKey()

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

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

रिटर्न

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

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