google-apps-script ट्यूटोरियल
Google-apps-script के साथ आरंभ करना

टिप्पणियों

स्थापना या सेटअप

Google Apps स्क्रिप्ट को सेटअप या स्थापना की आवश्यकता नहीं है। एकमात्र आवश्यकता Google खाता है। एक जीमेल अकाउंट काम करता है और साथ ही Google Apps for Work / Education / Government खाता भी काम करता है। आप के लिए जा रहा द्वारा एक नया Google खाता बना सकते हैं accounts.google.com

Script.google.com पर जाकर अपनी पहली स्क्रिप्ट शुरू करें। आप Google Apps Script को tools -> Script editor... तहत tools -> Script editor... कई Google ऐप्स के डॉक्स, शीट्स, फॉर्म आदि के माध्यम से भी एक्सेस कर सकते हैं। Google Apps स्क्रिप्ट को सीधे Connect more apps.. सुविधा के साथ आपके Google ड्राइव में भी जोड़ा जा सकता है।

आधिकारिक दस्तावेज़ीकरण Developers.google.com/apps-script/ पर देखे जा सकते हैं।

ऐप-स्क्रिप्ट को चलाने के लिए उनके पास एक code.gs फ़ाइल होनी चाहिए। Code.gs फ़ाइल में doGet (स्टैंडअलोन स्क्रिप्ट) या ऑनऑन फ़ंक्शन (एडऑन स्क्रिप्ट) नाम का फ़ंक्शन होना चाहिए। प्रलेखन में त्वरित शुरुआत के उदाहरण हैं।

यदि ऐप-स्क्रिप्ट में कोई एपीआई चालू है, तो उसे डेवलपर्स-कंसोल में भी चालू किया जाना चाहिए। हालाँकि, डेवलपर्स कंसोल में एपीआई होता है जिसे चालू किया जा सकता है लेकिन ऐप-स्क्रिप्ट इंटरफ़ेस में दिखाई नहीं देता है। उदाहरण के लिए, मार्केटप्लेस एसडीके को ऐप प्ले से पहले Google प्ले स्टोर या जी सूट डोमेन वाइड परिनियोजन में प्रकाशित किया जा सकता है।

शिक्षा / कार्य / सरकार के लिए Google ऐप्स के लिए डोमेन व्यवस्थापक कंसोल में ऐसी सेटिंग्स हैं जिन्हें ऐप-स्क्रिप्ट को चलाने की अनुमति देने या अस्वीकार करने के लिए समायोजित किया जा सकता है।

लिपियों के प्रकार

Google ऐप स्क्रिप्ट तीन प्रकार की होती हैं।

• स्टैंडअलोन
• Google Apps के लिए बाध्य
• वेब ऐप्स

स्टैंडअलोन स्क्रिप्ट

स्टैंडअलोन स्क्रिप्ट किसी भी Google ऐप यानी डॉक्स, शीट्स या फॉर्म आदि के लिए बाध्य नहीं हैं । स्टैंडअलोन स्क्रिप्ट या तो script.google.com पर जाकर या Google ऐप स्क्रिप्ट को Google ड्राइव से जोड़कर बनाई जा सकती है। स्टैंडअलोन स्क्रिप्ट का उपयोग Google ऐप्स को स्वतंत्र रूप से प्रोग्राम करने के लिए किया जा सकता है, वेब ऐप के रूप में उपयोग किया जा सकता है या इंस्टॉल किए गए ट्रिगर से स्वचालित रूप से चलाने के लिए सेट किया जा सकता है। स्टैंडअलोन स्क्रिप्ट के लिए प्रलेखन देखें।

Google Apps के लिए बाध्य

Google Apps से जुड़ी स्क्रिप्ट को कंटेनर-बाउंड स्क्रिप्ट के रूप में भी जाना जाता है; स्टैंडअलोन लिपियों के विपरीत, Google ऐप यानी Google डॉक्स या Google शीट्स आदि के लिए बाध्य हैं। Google ऐप से tools> Script editor चयन करके कंटेनर बाउंड स्क्रिप्ट बनाई जा सकती है। कुछ विशेषताएं जैसे संवाद, संकेत, मेनू और साइडबार केवल कंटेनर-बद्ध स्क्रिप्ट द्वारा प्रदान किए जाते हैं। इसके अलावा, Google Add-ons बनाने के लिए कंटेनर-बाउंड स्क्रिप्ट का उपयोग किया जाता है। कंटेनर-बाउंड स्क्रिप्ट के लिए दस्तावेज़ देखें।

वेब ऐप्स

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

• एक doGet() या doPost() फ़ंक्शन शामिल करें।
• फ़ंक्शन HTML सेवा HtmlOutput ऑब्जेक्ट या सामग्री सेवा TextOutput ऑब्जेक्ट देता है।

Inshort, doGet() और doPost() फ़ंक्शंस क्रमशः http प्राप्त और पोस्ट अनुरोध हैंडलर्स की तरह काम करते हैं।

वेब ऐप्स पर अधिक जानकारी के लिए, आधिकारिक दस्तावेज देखें।

अपनी स्क्रिप्ट चलाना / डिबग करना

नीचे दिखाए अनुसार टूल बार से अपना कोड चलाने का प्रयास करें:

आपके कोड में, यदि आपके पास एक से अधिक फ़ंक्शन हैं, तो इसे चलाने से पहले, आपको उस फ़ंक्शन का उल्लेख करना चाहिए जिसे आप चलाना चाहते हैं। उदाहरण के लिए :

वैकल्पिक रूप से, आप कोड को चलाने के लिए अपने कीबोर्ड से ctrl + r दबा सकते हैं। यह पहले कोड को सेव करेगा, अगर सेव नहीं हुआ है, और फिर इसे रन करेगा। लेकिन, उस काम के लिए, आपको फ़ंक्शन का चयन करना होगा, जैसा कि ऊपर की छवि में देखा गया है।

इसके अलावा, यदि आपकी स्क्रिप्ट को कुछ बाहरी गतिविधियों द्वारा कॉल किया जाता है, तब भी आप कोड को निष्पादित करने के बाद कुछ भी लॉग कर रहे हैं, तो व्यू-> लॉग पर क्लिक करके लॉग देख पाएंगे।

नमस्ते दुनिया

हम नमस्ते को एक संदेश बॉक्स के रूप में कहने जा रहे हैं।

function helloWorld() 
{
  Browser.msgBox("Hello World");
}

स्क्रिप्ट निष्पादित करने के लिए, या तो, पर क्लिक करें या मेनू आइटम का चयन करें Run -> helloWorld

Google Apps स्क्रिप्ट पर एक गहरी नज़र

Google Apps स्क्रिप्ट एक जावास्क्रिप्ट आधारित प्लेटफ़ॉर्म-जैसा-एक-सेवा है जिसका उपयोग मुख्य रूप से Google Apps को स्वचालित और विस्तारित करने के लिए किया जाता है। ऐप्स स्क्रिप्ट Google के बुनियादी ढांचे पर विशेष रूप से चलती है, जिसमें सर्वर प्रोविजनिंग या कॉन्फ़िगरेशन की आवश्यकता नहीं होती है। एक ऑनलाइन आईडीई उन सभी सेवाओं को जोड़ने वाले संपूर्ण प्लेटफ़ॉर्म पर इंटरफ़ेस के रूप में कार्य करता है जो ऐप स्क्रिप्ट के लिए उपलब्ध हैं। उपयोगकर्ता प्रमाणीकरण OAuth2 के माध्यम से मंच में बेक किया गया है और स्क्रिप्ट लेखक द्वारा कोई कोड या सेटअप की आवश्यकता नहीं है।

एप्स स्क्रिप्ट सर्वर-साइड चलती है, लेकिन इसमें एचटीएमएल, सीएसएस, जावास्क्रिप्ट, या किसी अन्य ब्राउज़र समर्थित प्रौद्योगिकियों के साथ निर्मित उपयोगकर्ता इंटरफेस हो सकते हैं। Nodejs के विपरीत, जो घटना संचालित है, ऐप स्क्रिप्स एक थ्रेडेड मॉडल में चलता है। एक स्क्रिप्ट के सभी कॉल उस स्क्रिप्ट का एक अनूठा उदाहरण उत्पन्न करते हैं जो अन्य सभी उदाहरणों के अलगाव में चलता है। जब एक स्क्रिप्ट का एक उदाहरण निष्पादन को पूरा करता है तो यह नष्ट हो जाता है।

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

अभ्यास लेखन में ऐप्स लिपियाँ सरल हैं। नीचे एक सरल स्क्रिप्ट है जो टेम्पलेट स्प्रेडशीट से एक नई स्प्रेडशीट बनाता है।

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
}