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()

स्क्रिप्ट के टाइम ज़ोन की जानकारी देता है. नई स्क्रिप्ट डिफ़ॉल्ट रूप से स्वामी के समय क्षेत्र पर सेट होती हैं, लेकिन स्क्रिप्ट का समय क्षेत्र फ़ाइल > स्क्रिप्ट में प्रोजेक्ट प्रॉपर्टी Editor. ध्यान दें कि स्प्रेडशीट का एक अलग टाइम ज़ोन होता है, जिसे क्लिक करके बदला जा सकता है फ़ाइल > 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 — कुछ समय के लिए चालू उपयोगकर्ता कुंजी

ऐसे तरीके जो अब काम नहीं करते