Google Apps Script को एक्सप्लोर करें: कोड की चार लाइनों में Google Sheets, Maps, और Gmail को ऐक्सेस करें!

1. Google Apps Script के बारे में जानकारी

इस कोडलैब में, हम आपको Google की डेवलपर टेक्नोलॉजी को ऐक्सेस करने वाला कोड लिखने के सबसे आसान तरीकों में से एक के बारे में बताएंगे. यह सब JavaScript का इस्तेमाल करके किया जाता है. यह वेब डेवलपमेंट की मुख्य भाषा है. Google Apps Script का इस्तेमाल करके, आपको Google शीट की किसी सेल से सड़क का पता निकालने के लिए कोड लिखना होगा. इसके बाद, उस पते के आधार पर Google मैप जनरेट करना होगा. इसके बाद, Gmail का इस्तेमाल करके उस मैप को अटैचमेंट के तौर पर भेजना होगा. सबसे अच्छी बात क्या है? यह सिर्फ़ चार लाइनों का कोड होगा.

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

• Google Apps Script का इस्तेमाल, Google की अलग-अलग सेवाओं के साथ कैसे किया जाता है. जैसे, Google Sheets, Google Maps, और Gmail.
• Apps Script के लिए, ब्राउज़र में मौजूद एडिटर का इस्तेमाल करके कोड डेवलप करें.

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

• इंटरनेट ऐक्सेस करने की सुविधा वाला वेब ब्राउज़र
• Google खाता (Google Workspace खातों के लिए, एडमिन की अनुमति ज़रूरी हो सकती है)
• Google Sheets के बारे में बुनियादी जानकारी
• Sheets के A1 नोटेशन को पढ़ने की सुविधा

2. सर्वे

इस कोडलैब/ट्यूटोरियल का इस्तेमाल कैसे किया जाएगा?

सिर्फ़ इसे पढ़ें इसे पढ़ें और एक्सरसाइज़ पूरी करें

Google Workspace के डेवलपर टूल और एपीआई इस्तेमाल करने के अपने अनुभव को आप क्या रेटिंग देंगे?

शुरुआती सामान्य एडवांस

3. खास जानकारी

अब आपको पता चल गया है कि यह कोडलैब किस बारे में है. अब आपको क्या करना है?

1. Apps Script के बारे में कुछ जानकारी पाएं. यह JavaScript पर आधारित है.
2. Google Sheets स्प्रेडशीट बनाएं.
3. स्प्रेडशीट के सबसे ऊपर बाईं ओर मौजूद सेल (A1) में, मोहल्ले का पता डालें.
4. किसी भी दस्तावेज़ के लिए, Apps Script एडिटर खोलने का तरीका जानें.
5. Apps Script कोड में बदलाव करें, उसे सेव करें, और चलाएं.
6. नतीजा देखने के लिए, Gmail का इस्तेमाल करें.

चलिए, शुरू करते हैं।

Google Apps Script क्या है?

Google Apps Script एक डेवलपमेंट प्लैटफ़ॉर्म है. इसकी मदद से, Google Workspace के साथ इंटिग्रेट होने वाली स्क्रिप्ट और छोटे ऐप्लिकेशन आसानी से और तेज़ी से बनाए जा सकते हैं. Apps Script की मदद से, ये काम किए जा सकते हैं:

• JavaScript में कोड लिखें. साथ ही, Gmail, Calendar, Drive वगैरह जैसे Google Workspace ऐप्लिकेशन के लिए, पहले से मौजूद लाइब्रेरी ऐक्सेस करें.
• कुछ भी इंस्टॉल करने की ज़रूरत नहीं है—हम आपको सीधे आपके ब्राउज़र में कोड एडिटर देते हैं. साथ ही, आपकी स्क्रिप्ट Google के सर्वर पर चलती हैं.
• आपको सुरक्षा और डेटा ऐक्सेस करने की अनुमतियों जैसे मुश्किल विषयों के बारे में चिंता करने की ज़रूरत नहीं है, क्योंकि प्लैटफ़ॉर्म इसे आपके लिए मैनेज करता है.

NOTE: JavaScript कोड लिखने का तरीका, इस कोडलैब के दायरे से बाहर है. हमारा मकसद है कि आप Apps Script डेवलपमेंट एनवायरमेंट का आसानी से इस्तेमाल कर पाएं. साथ ही, यह जान पाएं कि इसकी मदद से किस तरह के ऐप्लिकेशन बनाए जा सकते हैं.

अगर आपको JavaScript के बारे में ज़्यादा जानकारी नहीं है, तो Codecademy पर Introductory JavaScript कोर्स मुफ़्त में उपलब्ध है. Google ने इस कोर्स को नहीं बनाया है. हालांकि, इसमें आपको ज़रूरी सभी जानकारी मिल जाएगी.

Apps Script का इस्तेमाल, चैट बॉट से लेकर वेब ऐप्लिकेशन तक कई तरह के ऐप्लिकेशन बनाने के लिए किया जा सकता है. इसका सबसे ज़्यादा इस्तेमाल, Google Sheets स्प्रेडशीट की सुविधाओं को बढ़ाने के लिए किया जाता है. इस कोडलैब के बाकी हिस्से में, आपको Apps Script का इस्तेमाल करके, स्प्रेडशीट से डेटा लेने और उसे Google की अन्य सेवाओं से कनेक्ट करने का तरीका बताया जाएगा.

4. Google शीट बनाना और उसमें मोहल्ले का पता डालना

नई Google शीट में, मोहल्ले का मान्य पता डालें. इसके लिए, यह तरीका अपनाएं:

1. इस लिंक (sheets.google.com/create) का इस्तेमाल करके, Google शीट बनाएं. इसके अलावा, Google Drive (drive.google.com) पर जाएं और नया > Google Sheets > खाली स्प्रेडशीट पर क्लिक करें

2. खाली स्प्रेडशीट में, सबसे ऊपर बाएं कोने में मौजूद पहले सेल (A1) पर जाएं. यह कॉलम A और लाइन 1 में होगा. अगर आपको इसके बारे में फिर से जानना है, तो A1 नोटेशन के बारे में जानकारी देखें.
3. सेल में मोहल्ले का मान्य पता डालें. दुनिया में किसी भी जगह का पता चुनें. इसके लिए, सड़क का पता, ज़िप/पिन कोड या शहर और राज्य/प्रांत का कॉम्बिनेशन इस्तेमाल करें. यहां न्यूयॉर्क शहर के पते का एक उदाहरण दिया गया है:

आपको बस इतना ही करना है. आइए, एडिटर खोलें और कुछ कोड लिखें.

5. Apps Script कोड में बदलाव करना

अब आपके पास नई Google शीट है. इसलिए, अब इसकी बाउंड स्क्रिप्ट में बदलाव करने का समय आ गया है. ऐसा करने के लिए, यह तरीका अपनाएं:

स्क्रिप्ट एडिटर खोलें

Apps Script के लिए ब्राउज़र कोड एडिटर खोलने के लिए, मेन्यू बार में जाकर एक्सटेंशन > Apps Script चुनें.

नए ब्राउज़र टैब में, कोड एडिटर, शीट के लिए डिफ़ॉल्ट कंटेनर-बाउंड स्क्रिप्ट दिखाता है. myFunction() नाम का एक डिफ़ॉल्ट फ़ंक्शन अपने-आप बन जाता है. साथ ही, आपका कर्सर फ़ंक्शन के अंदर रखा जाता है, ताकि आप इसका इस्तेमाल शुरू कर सकें.

पते का Google मैप ईमेल करना

आपको दिया गया "टेंप्लेट" कोड खाली है. इसलिए, इसे अपने ऐप्लिकेशन से बदलें.

1. स्क्रिप्ट एडिटर में, डिफ़ॉल्ट myFunction() कोड ब्लॉक की जगह यह कोड डालें:

/** @OnlyCurrentDoc */
function sendMap() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var address = sheet.getRange('A1').getValue();
  var map = Maps.newStaticMap().addMarker(address);
  GmailApp.sendEmail('YOUR_EMAIL_ADDR', 'Map', 'See below.', {attachments:[map]});
}

2. प्लेसहोल्डर ईमेल पते ('YOUR_EMAIL_ADDR') को किसी मान्य ईमेल पते से बदलें. उदाहरण के लिए, [e-mail].
3. अपनी स्क्रिप्ट सेव करने के लिए, सेव करें पर क्लिक करें.
4. अपने Apps Script प्रोजेक्ट का नाम बदलने के लिए, बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें. इसके बाद, अपने प्रोजेक्ट के लिए कोई टाइटल डालें और नाम बदलें पर क्लिक करें.

कोड की समीक्षा

आइए, sendMap() फ़ंक्शन की चार लाइनों की समीक्षा करें. ये लाइनें ही पूरे ऐप्लिकेशन को बनाती हैं. दिलचस्प बात यह है कि कोड में Google के तीन अलग-अलग प्रॉडक्ट के रेफ़रंस दिए गए हैं.

पहली लाइन, एनोटेशन वाली टिप्पणी है. इससे अनुमति पर असर पड़ता है:

/** @OnlyCurrentDoc */

ज़्यादातर स्क्रिप्ट, उपयोगकर्ता से कुछ अनुमतियां मांगती हैं, ताकि वे चल सकें. इन अनुमतियों से यह कंट्रोल किया जाता है कि उपयोगकर्ता, स्क्रिप्ट को क्या करने की अनुमति दे रहा है. पहली लाइन में एक टिप्पणी है, जिसमें वैकल्पिक एनोटेशन शामिल है. इसमें Apps Script को यह निर्देश दिया गया है कि वह उपयोगकर्ता की सभी स्प्रेडशीट के बजाय, सिर्फ़ मौजूदा स्प्रेडशीट को ऐक्सेस करे. अगर आपको सिर्फ़ एक फ़ाइल के साथ काम करना है, तो इस एनोटेशन को शामिल करना हमेशा सबसे सही तरीका होता है.

इस कोड में, sendMap() के लिए सामान्य JavaScript फ़ंक्शन डेक्लेरेशन का इस्तेमाल किया गया है:

function sendMap() {

अगली लाइन में, SpreadsheetApp ऑब्जेक्ट के ज़रिए Apps Script से ऐक्सेस की जा सकने वाली Spreadsheet Service को कॉल किया जाता है. वापस की गई शीट को उसी नाम के वैरिएबल को असाइन किया जाता है. getActiveSheet() तरीके से, मौजूदा शीट ऑब्जेक्ट का रेफ़रंस मिलता है. इसे sheet वेरिएबल में सेव किया जाता है.

  var sheet = SpreadsheetApp.getActiveSheet();

sheet ऑब्जेक्ट की मदद से, हम getRange() का इस्तेमाल करके, A1 नोटेशन में सेल की रेंज (एक सेल की) का रेफ़रंस देते हैं. "रेंज" सेल का एक ग्रुप होता है. इसमें एक सेल भी शामिल हो सकती है, जैसे कि सेल A1 (जिसमें हमने पता डाला था). रेंज में मौजूद वैल्यू को फ़ेच करने के लिए, getValue() तरीके का इस्तेमाल किया जाता है. यह रेंज में सबसे ऊपर मौजूद बाएं सेल की वैल्यू दिखाता है और इस वैल्यू को वैरिएबल address को असाइन करता है. ज़्यादा पते जोड़कर और अलग-अलग सेल से डेटा पढ़कर भी देखा जा सकता है.

  var address = sheet.getRange('A1').getValue();

कोड की तीसरी लाइन, Maps ऑब्जेक्ट का इस्तेमाल करके, Google Maps Service से कनेक्ट होती है. newStaticMap() एक स्टैटिक मैप ऑब्जेक्ट बनाता है. साथ ही, addMarker() तरीके से, शीट में मौजूद पते का इस्तेमाल करके मैप में "पिन" जोड़ा जाता है.

  var map = Maps.newStaticMap().addMarker(address);

आखिर में, MailApp ऑब्जेक्ट के ज़रिए Gmail सेवा, sendEmail() तरीके को कॉल करती है. इससे, "नीचे देखें." टेक्स्ट और मैप इमेज को अटैचमेंट के तौर पर शामिल करके ईमेल भेजा जाता है.

  GmailApp.sendEmail('[e-mail]', 'Map', 'See below.', {attachments:[map]});
}

6. Google Sheets, Maps, और Gmail ऐप्लिकेशन चलाना

नाम देने और सेव करने के बाद, फ़ंक्शन को चलाने का समय आ जाता है. एडिटर में सबसे ऊपर, पक्का करें कि फ़ंक्शन की सूची में से sendMap() को चुना गया हो. इसके बाद, चलाएं पर क्लिक करें.

Apps Script की एक ऐसी सुविधा है जिसकी डेवलपर काफ़ी सराहना करते हैं. इसमें आपको अनुमति देने वाला कोड लिखने की ज़रूरत नहीं होती. यह कोड, प्रोग्राम को उपयोगकर्ता के डेटा का ऐक्सेस देता है. Apps Script इस सुविधा को मैनेज करती है. हालांकि, आपके ऐप्लिकेशन के उपयोगकर्ताओं को स्क्रिप्ट को अपनी स्प्रेडशीट ऐक्सेस करने और Gmail से ईमेल भेजने की अनुमति देनी होगी. अनुमति देने के लिए पहला डायलॉग बॉक्स ऐसा दिखता है:

जारी रखने के लिए, अनुमतियों की समीक्षा करें पर क्लिक करें.

ध्यान दें: अगर gmail.com खाते का इस्तेमाल किया जा रहा है, तो पहली बार स्क्रिप्ट का इस्तेमाल करते समय, आपको "इस ऐप्लिकेशन की पुष्टि नहीं हुई है" डायलॉग दिख सकता है. Google इस कुकी का इस्तेमाल उन लोगों को चेतावनी देने के लिए करता है जो अनजान या गैर-भरोसेमंद लेखकों के कोड का इस्तेमाल कर सकते हैं. अगर आपको यह डायलॉग दिखता है, तो आगे बढ़ें. इसकी वजह यह है कि स्क्रिप्ट आपने लिखी है. स्क्रिप्ट को अनुमति देने की प्रोसेस जारी रखने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें:

1. पुष्टि न किए गए ऐप्लिकेशन के डायलॉग बॉक्स में, ऐडवांस पर क्लिक करें.
2. your-project-name (unsafe) पर जाएं पर क्लिक करें.
3. अनुमति दें पर क्लिक करें.

इस कोडलैब के दौरान, आपको अनुमति से जुड़े कई प्रॉम्प्ट मिल सकते हैं. इस प्रोसेस के बारे में ज़्यादा जानने के लिए, Google की सेवाओं के लिए अनुमति लेख पढ़ें.

इसके बाद, आपको OAuth2 की डायलॉग विंडो दिखेगी. इसमें आपकी शीट को ऐक्सेस करने और आपकी ओर से ईमेल भेजने की अनुमति मांगी जाएगी:

अनुमति देने के बाद, स्क्रिप्ट पूरी तरह से रन होती है.

उस ईमेल खाते में जाएं जिससे आपने मैसेज भेजा था. आपको "Map" विषय वाला एक ईमेल मिलेगा. इसमें कुछ ऐसा मैसेज होगा:

ईमेल मैसेज में अटैचमेंट खोलने पर, आपको Google Maps दिखेगा. इसमें, शीट में डाला गया पता पिन किया गया होगा:

सिर्फ़ चार लाइनों के कोड की मदद से, आपने Google के तीन अलग-अलग प्रॉडक्ट को बेहतर तरीके से ऐक्सेस किया.

7. अन्य संसाधन

इस कोडलैब में दिखाया गया कोड, GitHub पर भी उपलब्ध है. इसके लिए, github.com/googleworkspace/apps-script-intro-codelab पर जाएं. इस कोडलैब में शामिल कॉन्टेंट के बारे में ज़्यादा जानने के लिए यहां कुछ और संसाधन दिए गए हैं. साथ ही, Google के डेवलपर टूल को प्रोग्राम के हिसाब से ऐक्सेस करने के अन्य तरीके भी बताए गए हैं.

दस्तावेज़

• Google Apps Script की दस्तावेज़ साइट
• Apps Script: Gmail सेवा
• Apps Script: Spreadsheet Service
• Apps Script: Maps Service

वीडियो

• Totally Unscripted
• Google Workspace Developer Show

खबरें और अपडेट

• Google Workspace Developers ब्लॉग
• Twitter: Google Workspace Developers (@workspacedevs)

अन्य कोडलैब

आसान लेवल

• [Google Sheets] Google Sheets के साथ Apps Script की बुनियादी बातें
• [REST API] Google Drive में मौजूद फ़ाइलों और फ़ोल्डर को ऐक्सेस करने के लिए, Google Workspace और Google API का इस्तेमाल करना

इंटरमीडिएट लेवल

• [Apps Script] Gmail के लिए Google Workspace ऐड-ऑन
• [Apps Script] Hangouts Chat के लिए कस्टम बॉट
• [REST API] Google Sheets को अपने ऐप्लिकेशन के रिपोर्टिंग टूल के तौर पर इस्तेमाल करना
• [REST API] BigQuery API का इस्तेमाल करके, Google Slides प्रज़ेंटेशन जनरेट करना

रेफ़रंस ऐप्लिकेशन

• Slides API का इस्तेमाल करके, Markdown और एचटीएमएल से Google Slides जनरेट करना