সেশন ক্লাসটি সেশনের তথ্য অ্যাক্সেস করার সুযোগ দেয়, যেমন ব্যবহারকারীর ইমেল ঠিকানা (কিছু ক্ষেত্রে) এবং ভাষার সেটিং।
পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
get Active User() | User | বর্তমান ব্যবহারকারী সম্পর্কে তথ্য সংগ্রহ করে। |
get Active User Locale() | String | বর্তমান ব্যবহারকারীর ভাষা সেটিং একটি স্ট্রিং হিসেবে গ্রহণ করে—উদাহরণস্বরূপ, ইংরেজির জন্য en । |
get Effective User() | User | যে ব্যবহারকারীর কর্তৃত্বের অধীনে স্ক্রিপ্টটি চলছে, তার সম্পর্কে তথ্য সংগ্রহ করে। |
get Script Time Zone() | String | স্ক্রিপ্টটির টাইম জোন বের করে। |
get Temporary Active User Key() | String | একটি অস্থায়ী কী পাওয়া যায় যা সক্রিয় ব্যবহারকারীর জন্য অনন্য, কিন্তু এটি ব্যবহারকারীর পরিচয় প্রকাশ করে না। |
বিস্তারিত ডকুমেন্টেশন
getActiveUser()
বর্তমান ব্যবহারকারী সম্পর্কে তথ্য সংগ্রহ করে। যদি নিরাপত্তা নীতি ব্যবহারকারীর পরিচয়ে অ্যাক্সেসের অনুমতি না দেয়, তাহলে User.getEmail() একটি ফাঁকা স্ট্রিং রিটার্ন করে। ইমেল ঠিকানাটি কোন পরিস্থিতিতে পাওয়া যাবে তা বিভিন্ন হতে পারে: উদাহরণস্বরূপ, ব্যবহারকারীর ইমেল ঠিকানা এমন কোনো প্রেক্ষাপটে পাওয়া যায় না যেখানে সেই ব্যবহারকারীর অনুমোদন ছাড়াই কোনো স্ক্রিপ্ট চালানো যায়, যেমন একটি সাধারণ onOpen(e) বা onEdit(e) ট্রিগার, গুগল শিটসের একটি কাস্টম ফাংশন, অথবা "execute as me" (অর্থাৎ, ব্যবহারকারীর পরিবর্তে ডেভেলপার দ্বারা অনুমোদিত) মোডে ডেপ্লয় করা একটি ওয়েব অ্যাপ। তবে, এই সীমাবদ্ধতাগুলো সাধারণত প্রযোজ্য হয় না যদি ডেভেলপার নিজেই স্ক্রিপ্টটি চালান অথবা ব্যবহারকারীর মতো একই গুগল ওয়ার্কস্পেস ডোমেইনের অন্তর্ভুক্ত হন।
// 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()
স্ক্রিপ্টের টাইম জোন নির্ধারণ করে। নতুন স্ক্রিপ্টগুলো ডিফল্টভাবে মালিকের টাইম জোন ব্যবহার করে, কিন্তু স্ক্রিপ্ট এডিটরে ফাইল > প্রজেক্ট প্রোপার্টিজ -এ ক্লিক করে স্ক্রিপ্টের টাইম জোন পরিবর্তন করা যায়। উল্লেখ্য যে, স্প্রেডশিটের একটি আলাদা টাইম জোন থাকে, যা গুগল শিটসে ফাইল > স্প্রেডশিট সেটিংস-এ ক্লিক করে পরিবর্তন করা যায়। স্প্রেডশিটের টাইম জোন যদি স্ক্রিপ্টের টাইম জোন থেকে ভিন্ন হয়, তবে তা প্রায়শই স্ক্রিপ্টিং বাগের একটি কারণ হয়ে দাঁড়ায়।
// Log the time zone of the script. const timeZone = Session.getScriptTimeZone(); Logger.log(timeZone);
ফেরত
String — স্ক্রিপ্টের সময় অঞ্চল
getTemporaryActiveUserKey()
একটি অস্থায়ী কী পাওয়া যায় যা সক্রিয় ব্যবহারকারীর জন্য অনন্য, কিন্তু এটি ব্যবহারকারীর পরিচয় প্রকাশ করে না। এই অস্থায়ী কী প্রতি ৩০ দিন পর পর পরিবর্তিত হয় এবং এটি স্ক্রিপ্টটির জন্য অনন্য।
// Log the temporary key of the person running the script. Logger.log(Session.getTemporaryActiveUserKey());
ফেরত
String — অস্থায়ী সক্রিয় ব্যবহারকারীর কী