این راهنما توضیح می‌دهد که چگونه یک افزونه می‌تواند منطقه محلی و منطقه زمانی کاربر را دریافت کند و سپس از آن اطلاعات برای سفارشی کردن رابط و رفتار خود استفاده کند. برای راهنمای ویژه اسکریپت Google Apps، به دریافت زبان کاربر و منطقه زمانی در اسناد برنامه‌نویس Apps Script مراجعه کنید.
منبع استقرار افزونه را پیکربندی کنید
برای اجازه دادن به یک افزونه برای دریافت منطقه محلی و منطقه زمانی کاربر، منبع استقرار افزونه را پیکربندی کنید:
- در منبع استقرار افزونه، فیلد
addOns.common.useLocaleFromAppرا رویtrueتنظیم کنید. - دامنه مجوز
https://www.googleapis.com/auth/script.localeرا به فهرستoauthScopesمنبع استقرار اضافه کنید. این محدوده به کاربر اجازه می‌دهد کشور، زبان و منطقه زمانی خود را مشاهده کند. - منبع استقرار به روز شده را ذخیره کنید.
پس از افزودن یک محدوده به لیست oauthScopes افزونه، کاربران باید دفعه بعد که از آن استفاده می‌کنند مجدداً مجوز آن را صادر کنند.
اطلاعات منطقه و منطقه زمانی را دریافت کنید
اشیاء رویداد شامل اطلاعات محلی کاربر است که می توانید از ویژگی های commonEventObject زیر بدست آورید:
-
commonEventObject.userLocale— زبان کاربر و شناسه کشور یا منطقه. به عنوان مثال،en-USنشان دهنده زبان انگلیسی است که در ایالات متحده صحبت می شود. -
commonEventObject.timeZone.offset—تغییر منطقه زمانی کاربر، بر حسب میلی ثانیه، از زمان هماهنگ جهانی (UTC) . -
commonEventObject.timeZone.id— شناسه منطقه زمانی کاربر. به عنوان مثال،America/New_York. -
commonEventObject.timeZone— شناسه و آفست منطقه زمانی کاربر.
به عنوان مثال، با کلیک کردن روی یک دکمه، اشیاء رویداد به توابع پاسخ به action ، توابع homepageTrigger و توابع contextualTrigger منتقل می‌شوند. هر تابع فراخوانی یا ماشه ای می تواند اطلاعات محلی و منطقه زمانی را از اشیاء رویداد دریافت کند و در صورت لزوم از آن استفاده کند. به عنوان مثال، یک تابع پاسخ به تماس که به یک کارت جدید هدایت می‌شود، می‌تواند هنگام تصمیم‌گیری متنی که به کارت اضافه شود، به رشته محلی اشاره کند.