Class Session

सेशन

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

तरीके

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

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
getTimeZone()	String	इससे स्क्रिप्ट का टाइम ज़ोन मिलता है.
getUser()	User	इस कुकी से मौजूदा उपयोगकर्ता के बारे में जानकारी मिलती है.

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

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 — यह सक्रिय उपयोगकर्ता की कुछ समय के लिए इस्तेमाल की जाने वाली कुंजी है

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

getTimeZone()

अब सेवा में नहीं है. यह फ़ंक्शन अब काम नहीं करता है. इसलिए, इसे नई स्क्रिप्ट में इस्तेमाल नहीं किया जाना चाहिए.

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

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

वापसी का टिकट

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

---

getUser()

अब सेवा में नहीं है. यह फ़ंक्शन अब काम नहीं करता है. इसलिए, इसे नई स्क्रिप्ट में इस्तेमाल नहीं किया जाना चाहिए.

इस कुकी से मौजूदा उपयोगकर्ता के बारे में जानकारी मिलती है.

वापसी का टिकट

User — फ़िलहाल, साइन इन किया हुआ उपयोगकर्ता

अनुमति देना

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

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