এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে একটি অ্যাড-অন একজন ব্যবহারকারীর লোকেল এবং টাইমজোন পেতে পারে এবং তারপর সেই তথ্যটি তার ইন্টারফেস এবং আচরণ কাস্টমাইজ করতে ব্যবহার করতে পারে। একটি Google Apps স্ক্রিপ্ট-নির্দিষ্ট গাইডের জন্য, অ্যাপস স্ক্রিপ্ট বিকাশকারী ডকুমেন্টেশনে ব্যবহারকারীর লোকেল এবং টাইমজোন পান দেখুন৷
অ্যাড-অনের স্থাপনার সংস্থান কনফিগার করুন
একটি ব্যবহারকারীর লোকেল এবং টাইমজোন পেতে অ্যাড-অনের অনুমতি দিতে, অ্যাড-অনের স্থাপনার সংস্থান কনফিগার করুন:
- অ্যাড-অনের স্থাপনার সংস্থানে ,
addOns.common.useLocaleFromApp
ক্ষেত্রটিকেtrue
সেট করুন। - স্থাপনার সংস্থানের
oauthScopes
তালিকায়https://www.googleapis.com/auth/script.locale
অনুমোদনের সুযোগ যোগ করুন। এই সুযোগ ব্যবহারকারীদের দেশ, ভাষা এবং টাইমজোন দেখার জন্য অ্যাড-অনকে অনুমতি দেয়। - আপডেট করা স্থাপনার সংস্থান সংরক্ষণ করুন।
অ্যাড-অনের oauthScopes
তালিকায় একটি সুযোগ যুক্ত করার পরে, ব্যবহারকারীদের অবশ্যই পরবর্তী সময়ে অ্যাড-অনটি ব্যবহার করার সময় পুনরায় অনুমোদন করতে হবে।
লোকেল এবং টাইমজোন তথ্য পান
ইভেন্ট অবজেক্টগুলিতে ব্যবহারকারীর লোকেল তথ্য অন্তর্ভুক্ত থাকে, যা আপনি নিম্নলিখিত commonEventObject
বৈশিষ্ট্যগুলি থেকে পেতে পারেন:
-
commonEventObject.userLocale
— ব্যবহারকারীর ভাষা এবং দেশ বা অঞ্চল শনাক্তকারী। উদাহরণস্বরূপ,en-US
মার্কিন যুক্তরাষ্ট্রে কথিত ইংরেজি ভাষার প্রতিনিধিত্ব করে। -
commonEventObject.timeZone.offset
— ব্যবহারকারীর টাইমজোন অফসেট, মিলিসেকেন্ডে, সমন্বিত ইউনিভার্সাল টাইম (UTC) থেকে। -
commonEventObject.timeZone.id
— ব্যবহারকারীর টাইমজোন শনাক্তকারী। উদাহরণস্বরূপ,America/New_York
। -
commonEventObject.timeZone
— ব্যবহারকারীর টাইমজোন আইডি এবং অফসেট।
ইভেন্ট অবজেক্টগুলি action
কলব্যাক ফাংশন, homepageTrigger
ফাংশন এবং contextualTrigger
ফাংশনে প্রেরণ করা হয় কারণ ব্যবহারকারী অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করে, উদাহরণস্বরূপ, একটি বোতামে ক্লিক করে। প্রতিটি কলব্যাক বা ট্রিগার ফাংশন ইভেন্ট অবজেক্ট থেকে লোকেল এবং টাইমজোন তথ্য পেতে পারে এবং এটি প্রয়োজনীয় হিসাবে ব্যবহার করতে পারে। উদাহরণস্বরূপ, একটি কলব্যাক ফাংশন যা একটি নতুন কার্ডে নেভিগেট করে তা কার্ডে কোন পাঠ্য যোগ করতে হবে তা নির্ধারণ করার সময় লোকেল স্ট্রিংকে নির্দেশ করতে পারে।