تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن لإضافات Google Workspace الوصول إلى لغة المستخدم والمنطقة الزمنية واستخدام
هذه المعلومات لتخصيص واجهتها وسلوكها. يجب ضبط بيان الإضافة
للسماح لها بالوصول إلى
هذه المعلومات.
ضبط ملف بيان الإضافة
يمكنك ضبط الإضافة للوصول إلى لغة المستخدم و
معلومات المنطقة الزمنية
من خلال اتّباع الخطوات التالية:
في ملف بيان
الإضافية، اضبط الحقل
addOns.common.useLocaleFromApp
على true.
إذا لم يكن النطاق الصريح التالي متوفّرًا، أضِفه إلى 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: رقم تعريف المنطقة الزمنية للمستخدم وفرق التوقيت
يتم تمرير عناصر الأحداث إلى
وظائف الاستدعاء للإجراءات
عندما يتفاعل المستخدم مع الإضافة، وإلى وظائف التفعيل
للصفحة الرئيسية
والسياقي. يمكن لكل وظيفة استدعاء أو وظيفة تشغيل قراءة
معلومات اللغة والمنطقة الزمنية من عنصر الحدث واستخدامها حسب الضرورة.
على سبيل المثال، يمكن أن تشير دالة الاستدعاء التي تتمثّل في
الانتقال إلى بطاقة جديدة
إلى سلسلة اللغة عند تحديد النص الذي سيتم إضافته إلى البطاقة.
تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],[]]
