الحصول على لغة المستخدم والمنطقة الزمنية

يمكن لإضافات Google Workspace الوصول إلى لغة المستخدم والمنطقة الزمنية الخاصة به واستخدامها. هذه المعلومات لتخصيص واجهتها وسلوكها. يجب ضبط بيان الإضافة للسماح للإضافة بالوصول إلى هذه المعلومات.

إعداد بيان الإضافة

يمكنك ضبط الإضافة للوصول إلى لغة المستخدم معلومات عن المنطقة الزمنية باتّباع الخطوات التالية:

1. في بيان الإضافة ملف، وتعيين addOns.common.useLocaleFromApp إلى true.
2. إذا لم يكن متوفّرًا بالفعل، أضِف النطاق الصريح التالي في oauthScopes في البيان :list 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 - رقم تعريف المنطقة الزمنية للمستخدم والإزاحة.

الاطّلاع على كائنات الأحداث لمزيد من التفاصيل.

يتم تمرير كائنات الحدث إلى دوال استدعاء الإجراءات وعندما يتفاعل المستخدم مع الإضافة، وإلى الصفحة الرئيسية والسياق دوال التشغيل. يمكن لكل دالة استدعاء أو تشغيل قراءة معلومات اللغة والمنطقة الزمنية من كائن الحدث واستخدِمها عند الضرورة. على سبيل المثال، دالة معاودة الاتصال التي الانتقال إلى بطاقة جديدة يمكن أن يشير إلى سلسلة اللغة عند تحديد النص الذي تريد إضافته إلى البطاقة.