Google Workspace के ऐड-ऑन, उपयोगकर्ता की स्थानीय भाषा और टाइमज़ोन को ऐक्सेस कर सकते हैं. साथ ही, इस जानकारी का इस्तेमाल करके अपने इंटरफ़ेस और काम करने के तरीके को उपयोगकर्ता के हिसाब से बना सकते हैं. अपने ऐड-ऑन को यह जानकारी ऐक्सेस करने की अनुमति देने के लिए, आपको अपने ऐड-ऑन के मेनिफ़ेस्ट को कॉन्फ़िगर करना होगा.
ऐड-ऑन मेनिफ़ेस्ट कॉन्फ़िगर करना
उपयोगकर्ता की स्थानीय भाषा और टाइमज़ोन की जानकारी ऐक्सेस करने के लिए, अपने ऐड-ऑन को कॉन्फ़िगर किया जा सकता है. इसके लिए, यह तरीका अपनाएं:
- अपने ऐड-ऑन की मेनिफ़ेस्ट फ़ाइल में,
addOns.common.useLocaleFromAppफ़ील्ड कोtrueपर सेट करें. - अगर यह पहले से मौजूद नहीं है, तो मेनिफ़ेस्ट की
oauthScopesसूची में यह साफ़ तौर पर तय किया गया स्कोप जोड़ें:https://www.googleapis.com/auth/script.locale
अगर आपने ऐड-ऑन की oauthScope सूची में कोई स्कोप जोड़ा है, तो अगली बार ऐड-ऑन खोलने पर, उपयोगकर्ताओं को उसे फिर से अनुमति देनी होगी.
स्थानीय भाषा और टाइमज़ोन की जानकारी पाना
सही तरीके से कॉन्फ़िगर किए जाने पर, इवेंट ऑब्जेक्ट में उपयोगकर्ता की स्थानीय भाषा की जानकारी होती है. ये फ़ील्ड, इवेंट ऑब्जेक्ट के commonEventObject सबस्ट्रक्चर में दिखते हैं:
commonEventObject.userLocale—उपयोगकर्ता की भाषा और देश/इलाके का आइडेंटिफ़ायर. उदाहरण के लिए,en-US.commonEventObject.timeZone.offset—उपयोगकर्ता के टाइमज़ोन का ऑफ़सेट, कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) से मिले मिलिसेकंड में.commonEventObject.timeZone.id—उपयोगकर्ता के टाइमज़ोन का आइडेंटिफ़ायर. उदाहरण के लिए,America/New_York.commonEventObject.timeZone—उपयोगकर्ता का टाइमज़ोन आईडी और ऑफ़सेट.
ज़्यादा जानकारी के लिए, इवेंट ऑब्जेक्ट देखें.
जब उपयोगकर्ता आपके ऐड-ऑन से इंटरैक्ट करता है, तो इवेंट ऑब्जेक्ट को ऐक्शन कॉलबैक फ़ंक्शन और होम पेज और संदर्भ के हिसाब से ट्रिगर करने वाले फ़ंक्शन में पास किया जाता है. हर कॉलबैक या ट्रिगर फ़ंक्शन, इवेंट ऑब्जेक्ट से भाषा और टाइमज़ोन की जानकारी पढ़ सकता है और ज़रूरत के हिसाब से उसका इस्तेमाल कर सकता है. उदाहरण के लिए, नए कार्ड पर नेविगेट करने वाला कॉलबैक फ़ंक्शन, कार्ड में कौनसा टेक्स्ट जोड़ना है, यह तय करते समय स्थानीय भाषा की स्ट्रिंग का इस्तेमाल कर सकता है.