يشرح هذا الدليل كيف يمكن للإضافة الحصول على لغة المستخدم ومنطقته الزمنية ثم استخدام هذه المعلومات لتخصيص واجهتها وسلوكها. للحصول على دليل خاص ببرمجة تطبيقات Google، اطّلع على الحصول على لغة المستخدم والمنطقة الزمنية في وثائق مطوّري برامج برمجة التطبيقات.
إعداد مورد نشر الإضافة
للسماح للإضافة بالحصول على لغة المستخدم ومنطقته الزمنية، اضبط مورد النشر للإضافة:
- في مورد
النشر للإضافة،
اضبط الحقل
addOns.common.useLocaleFromApp
علىtrue
. - أضِف نطاق تفويض
https://www.googleapis.com/auth/script.locale
إلى قائمةoauthScopes
لمورد النشر. يمنح هذا النطاق الإذن الإضافي للمستخدم لعرض بلده ولغته ومنطقته الزمنية. - احفظ مورد النشر المعدّل.
بعد إضافة نطاق إلى قائمة
oauthScopes
للإضافة،
على المستخدمين إعادة تفويض الإضافة في المرة التالية التي يستخدمونها فيها.
الحصول على معلومات عن المنطقة الزمنية والمنطقة الزمنية
تتضمن كائنات الأحداث
معلومات لغة المستخدم، التي يمكنك الحصول عليها من سمات
commonEventObject
التالية:
commonEventObject.userLocale
: لغة المستخدم ومعرّف البلد أو المنطقة على سبيل المثال، يمثّلen-US
اللغة الإنجليزية كما هو مستخدم في الولايات المتحدة.commonEventObject.timeZone.offset
: معادلة المنطقة الزمنية للمستخدم، بالملّي ثانية، من التوقيت العالمي المنسّق (UTC)commonEventObject.timeZone.id
: معرِّف المنطقة الزمنية للمستخدم. مثلاً،America/New_York
.commonEventObject.timeZone
: رقم تعريف المنطقة الزمنية للمستخدم والإزاحة
يتم تمرير كائنات الأحداث إلى دوال معاودة الاتصال في action
ودوال homepageTrigger
ووظائف contextualTrigger
أثناء تفاعل المستخدم مع الإضافة بالنقر على زر مثلاً. ويمكن لكل دالة استدعاء أو دالة تفعيل إمكانية الحصول على معلومات اللغة والمنطقة الزمنية من
كائنات الأحداث
واستخدامها حسب الضرورة. على سبيل المثال، عند الانتقال إلى بطاقة جديدة، قد تشير دالة معاودة الاتصال إلى سلسلة اللغة عند تحديد النص الذي تريد إضافته إلى البطاقة.