AppSheet को Apps Script से कनेक्ट करना

1. परिचय

इस कोडलैब में, आपको "Hello World" नाम का एक Apps Script प्रोजेक्ट बनाना है. इसके बाद, आपको एक आसान फ़ंक्शन, logThis जोड़ना है. यह फ़ंक्शन, इसे भेजे गए मैसेज को लॉग करता है. इसके बाद, AppSheet ऑटोमेशन बनाएं और उसे स्क्रिप्ट को कॉल करने के लिए सेट करें. स्क्रिप्ट को कॉल करने के बाद, आपको Apps Script एडिटर पर वापस भेज दिया जाता है. यहां आपको स्क्रिप्ट के चलने की पुष्टि करनी होती है.

आपको क्या सीखने को मिलेगा

• आसान फ़ंक्शन वाला Apps Script प्रोजेक्ट बनाने का तरीका.
• किसी मौजूदा Google शीट के आधार पर, AppSheet का सामान्य ऐप्लिकेशन बनाने का तरीका.
• स्क्रिप्ट फ़ंक्शन को कॉल करने वाला AppSheet ऑटोमेशन कैसे बनाएं.
• AppSheet से स्क्रिप्ट के सही तरीके से लागू होने की जांच कैसे करें.

आपको इन चीज़ों की ज़रूरत होगी

• AppSheet डेवलपमेंट एनवायरमेंट (appsheet.com) का ऐक्सेस.
• Apps Script डेवलपमेंट एनवायरमेंट (script.google.com) का ऐक्सेस.

2. Apps Script प्रोजेक्ट बनाना

सबसे पहले, "Hello World" नाम का Apps Script प्रोजेक्ट बनाएं. इसके बाद, एक आसान फ़ंक्शन, logThis जोड़ें. यह फ़ंक्शन, इसे भेजे गए मैसेज को लॉग करता है.

1. Apps Script के होम पेज पर जाएं. इसके बाद, + नया प्रोजेक्ट पर क्लिक करें.
2. प्रोजेक्ट का टाइटल बदलकर Hello World. कर दिया गया
3. एडिटर में स्क्रिप्ट को इस तरह अपडेट करें:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. प्रोजेक्ट सेव करें पर क्लिक करें.

ज़्यादा जानकारी के लिए, प्रोजेक्ट बनाना और मिटाना लेख पढ़ें.

3. AppSheet ऐप्लिकेशन बनाना

इसके बाद, कॉपी की गई उदाहरण Google शीट के आधार पर, AppSheet ऐप्लिकेशन जनरेट करें. इसके बाद, इसे अपडेट करके उस Apps Script प्रोजेक्ट को कॉल करें जिसे आपने पहले बनाया था.

1. शर्ट के ऑर्डर का उदाहरण वाली स्प्रेडशीट खोलें. इसके बाद, Google Sheets में इसकी कॉपी डाउनलोड करने और खोलने के लिए, कॉपी बनाएं पर क्लिक करें. अगर चाहें, तो स्प्रेडशीट का नाम बदला जा सकता है. उदाहरण के लिए,"शर्ट के ऑर्डर".
2. AppSheet में साइन इन करें.
3. 'मेरे ऐप्लिकेशन' पेज पर, + नया ऐप्लिकेशन बनाएं पर क्लिक करें. इसके बाद, नया ऐप्लिकेशन बनाएं डायलॉग बॉक्स दिखेगा.
4. अपने डेटा का इस्तेमाल करके शुरू करें पर क्लिक करें.
5. ऐप्लिकेशन का नाम बदलें और कोई कैटगरी चुनें. हालाँकि, ऐसा करना ज़रूरी नहीं है.
6. अपना डेटा चुनें पर क्लिक करें.

7. Google Drive को ऐक्सेस करने के लिए, google पर क्लिक करें.
8. उस शर्ट के ऑर्डर स्प्रेडशीट पर जाएं और उसे चुनें जिसे आपने पहले कॉपी किया था.

AppSheet आपके ऐप्लिकेशन को सेट अप करता है.

9. AppSheet Editor में ऐप्लिकेशन खोलने के लिए, अपने ऐप्लिकेशन को पसंद के मुताबिक बनाएं पर क्लिक करें.

4. ऑटोमेशन बनाना

इसके बाद, AppSheet ऑटोमेशन बनाएं और उसे स्क्रिप्ट को कॉल करने के लिए सेट करें.

1. ऑटोमेशन > बॉट चुनें.
2. + नया बॉट पर क्लिक करें.
3. सुझावों की सूची में पहला आइटम चुनें: शर्ट के ऑर्डर का रिकॉर्ड बनने या अपडेट होने पर, सूचना भेजें.

4. बदलाव करने के लिए, सूचना भेजें चरण पर क्लिक करें.
5. नाम बदलकर Call a script कर दें.

6. सेटिंग में जाकर, टास्क टाइप को स्क्रिप्ट को कॉल करें में बदलें.

7. Apps Script प्रोजेक्ट फ़ील्ड में, ब्राउज़ करें (फ़ाइल आइकॉन) पर क्लिक करें.
8. अपनी Drive में मौजूद Hello World Apps Script प्रोजेक्ट पर जाएं और उसे चुनें.
9. चुनें पर क्लिक करें. अगर अनुमति देने के लिए कहा जाए, तो अनुमति दें पर क्लिक करें और दिए गए निर्देशों का पालन करें.

Apps Script प्रोजेक्ट जुड़ जाता है. साथ ही, फ़ंक्शन का नाम फ़ील्ड में, उपलब्ध फ़ंक्शन की सूची दिखती है.

10. फ़ंक्शन का नाम सूची से logThis(msg) चुनें.

आपको फ़ंक्शन के आर्ग्युमेंट फ़ील्ड दिखेगा.

11. msg आर्ग्युमेंट के लिए, एक्सप्रेशन असिस्टेंट का इस्तेमाल करके यह एक्सप्रेशन डालें: ‘Hello from AppSheet'

12. ऐप्लिकेशन को सेव करने के लिए, सेव करें पर क्लिक करें.
13. ऐप एमुलेटर दिखाने के लिए, झलक पैनल में मौजूद मोबाइल या टैबलेट आइकॉन पर क्लिक करें.

14. शर्ट का नया ऑर्डर जोड़ें और सेव करें पर क्लिक करें.
15. बदलावों को सिंक करने के लिए, सिंक करें पर क्लिक करें.

5. Apps Script के लागू होने की पुष्टि करना

स्क्रिप्ट को कॉल करने के बाद, Apps Script एडिटर पर वापस जाएं और उसके एक्ज़ीक्यूशन की पुष्टि करें.

1. Apps Script के होम पेज पर वापस जाएं और Hello World प्रोजेक्ट देखें.
2. नेविगेशन बार में, Executions पर क्लिक करके पुष्टि करें कि logThis फ़ंक्शन पूरा हो गया है. अगर लॉग नहीं दिखता है, तो रीफ़्रेश करें पर क्लिक करें.

6. अतिरिक्त चरण (ज़रूरी नहीं)

इस वर्कशॉप में एक अतिरिक्त चरण के तौर पर, Apps Script के उदाहरणों वाले प्रोजेक्ट की समीक्षा करें. साथ ही, AppSheet से कुछ उदाहरण चलाएँ.

Apps Script के उदाहरणों का इस्तेमाल शुरू करना

1. शुरू करने के लिए, सबसे पहले Apps Script के उदाहरणों वाले प्रोजेक्ट की कॉपी बनाएं.
2. कॉपी करें आइकॉन पर क्लिक करें.
3. नए प्रोजेक्ट को सेव करें. इसके बाद, प्रोजेक्ट में मौजूद ऐप्लिकेशन को अनुमति देने के लिए, चलाएं पर क्लिक करें.

कई उदाहरणों के साथ एक्सपेरिमेंट करें

• createCalendarEvent() - नया Calendar इवेंट बनाएं.
• createDoc() - अपने-आप एक नया दस्तावेज़ बन जाता है.
• createSheet() - नई शीट बनाएं.
• createSlideDeck() - किसी इमेज और टेक्स्ट का इस्तेमाल करके, नया स्लाइड डेक बनाएं.

इस ज़रूरी सुविधा के बारे में ज़्यादा जानने के लिए, ऑटोमेशन से Apps Script को कॉल करना लेख पढ़ें. इसमें इस सुविधा के बारे में पूरी जानकारी दी गई है. साथ ही, सुविधा का वीडियो, ट्यूटोरियल, और Apps Script का ऐसा प्रोजेक्ट दिया गया है जिसे कॉपी किया जा सकता है. इसमें AppSheet और Apps Script के कई उदाहरण दिए गए हैं.