منطقه محلی و منطقه زمانی کاربر را دریافت کنید

افزونه های Google Workspace می توانند به منطقه محلی و منطقه زمانی کاربر خود دسترسی داشته باشند و از آن اطلاعات برای سفارشی کردن رابط کاربری و رفتار خود استفاده کنند. باید مانیفست افزونه خود را پیکربندی کنید تا به افزونه شما اجازه دسترسی به این اطلاعات را بدهد.

مانیفست افزونه را پیکربندی کنید

می‌توانید افزونه خود را برای دسترسی به اطلاعات محلی کاربر و منطقه زمانی با مراحل زیر پیکربندی کنید:

  1. در فایل مانیفست افزونه خود، فیلد addOns.common.useLocaleFromApp را روی true تنظیم کنید.
  2. اگر قبلاً موجود نیست، دامنه صریح زیر را در فهرست 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 — شناسه و آفست منطقه زمانی کاربر.

برای جزئیات بیشتر به اشیاء رویداد مراجعه کنید.

با تعامل کاربر با افزونه شما، اشیاء رویداد به توابع پاسخ به فراخوان کنش و به صفحه اصلی و توابع راه‌انداز متنی منتقل می‌شوند. هر تابع فراخوانی یا راه‌اندازی می‌تواند اطلاعات محلی و منطقه زمانی را از شی رویداد بخواند و در صورت لزوم از آن استفاده کند. به عنوان مثال، یک تابع پاسخ به تماس که در حال پیمایش به یک کارت جدید است، می‌تواند هنگام تصمیم‌گیری متنی که به کارت اضافه شود، به رشته محلی اشاره کند.