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

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

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

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

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

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

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

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

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

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

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

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