ऐड-ऑन अपने उपयोगकर्ता की स्थान-भाषा और टाइमज़ोन को ऐक्सेस कर सकते हैं. साथ ही, वे उस जानकारी का इस्तेमाल करके अपने इंटरफ़ेस और व्यवहार को पसंद के मुताबिक बना सकते हैं. आपको अपने ऐड-ऑन का मेनिफ़ेस्ट कॉन्फ़िगर करना होगा, ताकि आपका ऐड-ऑन यह जानकारी ऐक्सेस कर सके.
ऐड-ऑन मेनिफ़ेस्ट को कॉन्फ़िगर करना
उपयोगकर्ता की स्थान-भाषा और टाइमज़ोन की जानकारी ऐक्सेस करने के लिए, ऐड-ऑन को कॉन्फ़िगर किया जा सकता है. इसके लिए, यह तरीका अपनाएं:
- अपने ऐड-ऑन की मेनिफ़ेस्ट फ़ाइल में,
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—उपयोगकर्ता का टाइमज़ोन आईडी और ऑफ़सेट.
ज़्यादा जानकारी के लिए, इवेंट ऑब्जेक्ट देखें.
जब उपयोगकर्ता आपके ऐड-ऑन के साथ इंटरैक्ट करता है, तब इवेंट ऑब्जेक्ट ऐक्शन कॉलबैक फ़ंक्शन में पास किए जाते हैं. साथ ही, इन्हें होम पेज और कॉन्टेक्स्ट ट्रिगर फ़ंक्शन के लिए भी भेजा जाता है. हर कॉलबैक या ट्रिगर फ़ंक्शन, इवेंट ऑब्जेक्ट से स्थान-भाषा और टाइमज़ोन की जानकारी पढ़ सकता है और ज़रूरत के मुताबिक उसका इस्तेमाल कर सकता है. उदाहरण के लिए, नए कार्ड पर जाने वाला कॉलबैक फ़ंक्शन, कार्ड में जोड़ने के लिए टेक्स्ट तय करते समय, स्थान-भाषा वाली स्ट्रिंग पर गौर कर सकता है.