افزونه‌ها می‌توانند به محلی و منطقه زمانی کاربر خود دسترسی داشته باشند و از آن اطلاعات برای سفارشی کردن رابط و رفتار آن استفاده کنند. باید مانیفست افزونه خود را پیکربندی کنید تا به افزونه شما اجازه دسترسی به این اطلاعات را بدهد.
مانیفست افزونه را پیکربندی کنید
می‌توانید افزونه خود را برای دسترسی به اطلاعات محلی کاربر و منطقه زمانی با مراحل زیر پیکربندی کنید:
- در فایل مانیفست افزونه خود، فیلد
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— شناسه و آفست منطقه زمانی کاربر.
برای جزئیات بیشتر به اشیاء رویداد مراجعه کنید.
با تعامل کاربر با افزونه شما، اشیاء رویداد به توابع پاسخ به فراخوان کنش و به صفحه اصلی و توابع راه‌انداز متنی منتقل می‌شوند. هر تابع فراخوانی یا راه‌اندازی می‌تواند اطلاعات محلی و منطقه زمانی را از شی رویداد بخواند و در صورت لزوم از آن استفاده کند. به عنوان مثال، یک تابع پاسخ به تماس که در حال پیمایش به یک کارت جدید است، می‌تواند هنگام تصمیم‌گیری متنی که به کارت اضافه شود، به رشته محلی اشاره کند.