يمكن للإضافات الوصول إلى لغة المستخدم ومنطقته الزمنية واستخدام هذه المعلومات لتخصيص واجهته وسلوكه. يجب إعداد بيان الإضافة للسماح للإضافات بالوصول إلى هذه المعلومات.
ضبط بيان الإضافة
يمكنك ضبط الإضافة للوصول إلى معلومات لغة المستخدم والمنطقة الزمنية باتّباع الخطوات التالية:
- في ملف البيان للإضافة، اضبط
الحقل
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
: رقم تعريف المنطقة الزمنية للمستخدم والإزاحة
يُرجى الاطّلاع على كائنات الأحداث للحصول على مزيد من التفاصيل.
يتم تمرير عناصر الأحداث إلى دوال استدعاء الإجراء أثناء تفاعل المستخدم مع الإضافة وإلى الصفحة الرئيسية ودوال عامل التفعيل السياقي. يمكن لكل استدعاء أو دالة تشغيل قراءة معلومات اللغة والمنطقة الزمنية من كائن الحدث واستخدامها حسب الضرورة. على سبيل المثال، قد تشير دالة معاودة الاتصال التي تنتقل إلى بطاقة جديدة إلى سلسلة اللغة عند تحديد النص المراد إضافته إلى البطاقة.