با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
افزونه های Google Workspace می توانند به منطقه محلی و منطقه زمانی کاربر خود دسترسی داشته باشند و از آن اطلاعات برای سفارشی کردن رابط کاربری و رفتار خود استفاده کنند. باید مانیفست افزونه خود را پیکربندی کنید تا به افزونه شما اجازه دسترسی به این اطلاعات را بدهد.
مانیفست افزونه را پیکربندی کنید
می‌توانید افزونه خود را برای دسترسی به اطلاعات محلی کاربر و منطقه زمانی با مراحل زیر پیکربندی کنید:
در فایل مانیفست افزونه خود، فیلد 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 — شناسه و آفست منطقه زمانی کاربر.
با تعامل کاربر با افزونه شما، اشیاء رویداد به توابع پاسخ به فراخوان کنش و به صفحه اصلی و توابع راه‌انداز متنی منتقل می‌شوند. هر تابع فراخوانی یا راه‌اندازی می‌تواند اطلاعات محلی و منطقه زمانی را از شی رویداد بخواند و در صورت لزوم از آن استفاده کند. به عنوان مثال، یک تابع پاسخ به تماس که در حال پیمایش به یک کارت جدید است، می‌تواند هنگام تصمیم‌گیری متنی که به کارت اضافه شود، به رشته محلی اشاره کند.
تاریخ آخرین بهروزرسانی 2025-06-05 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-06-05 بهوقت ساعت هماهنگ جهانی."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
