उपयोगकर्ता स्थान-भाषा और टाइमज़ोन पाएं

Google Workspace ऐड-ऑन, अपने उपयोगकर्ताओं की स्थान-भाषा और टाइमज़ोन को ऐक्सेस कर सकता है. साथ ही, उस जानकारी के इंटरफ़ेस और व्यवहार को कस्टमाइज़ कर सकें. आपको इसे कॉन्फ़िगर करना होगा आपके ऐड-ऑन का मेनिफ़ेस्ट ऐड-ऑन को ऐक्सेस करने की अनुमति देने के लिए यह जानकारी.

ऐड-ऑन मेनिफ़ेस्ट कॉन्फ़िगर करें

उपयोगकर्ता की स्थान-भाषा को ऐक्सेस करने के लिए, अपने ऐड-ऑन को कॉन्फ़िगर किया जा सकता है और टाइमज़ोन की जानकारी इसके लिए, यह तरीका अपनाएं:

  1. आपके ऐड-ऑन के मेनिफ़ेस्ट में फ़ाइल, addOns.common.useLocaleFromApp true के लिए फ़ील्ड.
  2. अगर यह पहले से मौजूद नहीं है, तो यहां दिया गया साफ़ तौर पर स्कोप जोड़ें मेनिफ़ेस्ट का 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—उपयोगकर्ता का टाइमज़ोन आईडी और ऑफ़सेट.

इवेंट ऑब्जेक्ट देखें देखें.

इवेंट ऑब्जेक्ट को ऐक्शन कॉलबैक फ़ंक्शन जब उपयोगकर्ता आपके ऐड-ऑन के साथ और होम पेज पर इंटरैक्ट करता है और कॉन्टेक्स्ट के हिसाब से ट्रिगर फ़ंक्शन. हर कॉलबैक या ट्रिगर फ़ंक्शन, इवेंट ऑब्जेक्ट से स्थान-भाषा और टाइमज़ोन की जानकारी हासिल करें और उसे ज़रूरत के मुताबिक इस्तेमाल करें. उदाहरण के लिए, एक कॉलबैक फ़ंक्शन जो नए कार्ड पर जाना कार्ड में कौनसा टेक्स्ट जोड़ना है, यह तय करते समय स्थान-भाषा वाली स्ट्रिंग को दिखाया जा सकता है.