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

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

ضبط ملف بيان الإضافة

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

  1. في ملف بيان الإضافية، اضبط الحقل addOns.common.useLocaleFromApp على true.
  2. إذا لم يكن النطاق الصريح التالي متوفّرًا، أضِفه إلى oauthScopes قائمة البيان: https://www.googleapis.com/auth/script.locale

إذا أضفت نطاقًا إلى قائمة oauthScope في الإضافة، على المستخدمين إعادة تفويض الإضافة في المرة التالية التي يتم فيها فتحها.

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

عناصر الأحداث: تنقل معلومات لغة المستخدِم عند ضبطها بشكلٍ صحيح. تظهر الحقول التالية في البنية الفرعية commonEventObject لكائن الحدث:

  • commonEventObject.userLocale: معرّف language وcountry/region للمستخدم مثلاً: en-US
  • commonEventObject.timeZone.offset: توقيت المنطقة الزمنية للمستخدم بالمليثواني مقارنةً بالتوقيت العالمي المنسق (UTC).
  • ‫commonEventObject.timeZone.id: معرّف المنطقة الزمنية للمستخدم مثلاً: America/New_York
  • commonEventObject.timeZone: رقم تعريف المنطقة الزمنية للمستخدم وفرق التوقيت

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

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