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