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