यदि आप Google Docs, Google Sheets, Google Analytics, Gmail, और अन्य जैसी Google सेवाओं का उपयोग करते हैं, तो आप Google Apps Script का उपयोग करके उन सेवाओं को कनेक्ट और स्वचालित कर सकते हैं।
Google Apps Script को Microsoft के VBA स्क्रिप्ट के Google के संस्करण के रूप में सोचें। जैसे आप Microsoft Word और Excel में VBA के साथ कार्यों और कार्यों को स्वचालित कर सकते हैं या मैक्रोज़ को अनुकूलित कर सकते हैं, आप Google सेवाओं में कार्यों और क्रियाओं को स्वचालित कर सकते हैं। Sheets और Docs जैसी सेवाओं में, आप अपने खुद के कस्टम मेनू भी लिख सकते हैं।
Google Apps Script Editor कैसे एक्सेस करें
आप कई Google सेवाओं के भीतर से Google Apps Script कोड एडिटर खोल सकते हैं। उदाहरण के लिए, आपको Google Sheets के अंदर Extensions मेनू में Apps Script मिलेगा।
अन्य सेवाओं में, आप Google Apps Script एडिटर को निम्न तरीकों से खोल सकते हैं:
- Google Docs: Tools मेनू में Script editor चुनें।
- Google Slides: Tools मेनू में Script editor चुनें।
- Google Forms: तीन-डॉट मेनू में Script editor चुनें।
- Google Drive: किसी भी खाली जगह पर राइट-क्लिक करें, More चुनें, और Google Apps Script चुनें।
इनमें से किसी भी विधि का उपयोग करके, आप Apps Script कोड एडिटर को एक नए टैब में खुला देखेंगे। यह वह विंडो है जहां आप प्रत्येक फ़ंक्शन लिखेंगे जो आपके पूरे स्क्रिप्ट को बनाता है। डिफ़ॉल्ट रूप से, आप एक खाली फ़ंक्शन देखेंगे जिसका नाम myFunction() है जो आपके कोड को भरना शुरू करने के लिए तैयार है।
नोट: त्रुटियों से बचने के लिए कोड फ़ॉर्मेटिंग बहुत महत्वपूर्ण है। जैसा कि निम्नलिखित कोड में दिखाया गया है, अपने आप को याद दिलाने के लिए कमेंटिंग का उपयोग करें कि आप कोड के अनुभागों के अंदर क्या करने की कोशिश कर रहे थे। यह वेब प्रोग्रामिंग में HTML कोड के साथ कमेंटिंग कैसे काम करती है, इसके बहुत समान है।
जैसे ही आप कोड एडिटर में नेविगेट करते हैं, आप Editor विंडो में बाएं नेविगेशन पेन में Code.gs का चयन करके इस अनुभाग पर लौट सकते हैं। अन्य उपलब्ध विंडो देखने के लिए, दूर बाएं पेन में आइकन पर होवर करें और मुख्य नेविगेशन पेन खुल जाएगा।
Overview अनुभाग वह जगह है जहां आप अपने स्क्रिप्ट के बारे में आंकड़े पा सकते हैं जैसे कितनी त्रुटियां हुई हैं, यह कितनी बार निष्पादित हुआ है, और बहुत कुछ।
हम नीचे प्रत्येक अनुभाग में Google Apps Script एडिटर के अन्य प्रत्येक अनुभाग को कवर करेंगे।
Google Apps Script Editor को नेविगेट करना
जैसे ही आप एडिटर में अपना कोड संपादित करते हैं, डिस्क (सेव) आइकन को अक्सर चुनना एक अच्छा विचार है ताकि आप अपना काम न खोएं।
एक बार सेव हो जाने पर, आप अन्य मेनू विकल्पों को चमकते हुए देखेंगे।
इनमें शामिल हैं:
- Run: अपने पूरे स्क्रिप्ट को शुरुआत से अंत तक चलाने का प्रयास करें।
- Debug: अपने स्क्रिप्ट को एक बार में एक लाइन के माध्यम से स्टेप करें।
- Function dropdown: आपके द्वारा बनाए गए प्रत्येक फ़ंक्शन के माध्यम से ब्राउज़ करें और नेविगेट करें।
- Execution log: आपके स्क्रिप्ट को चलाने के प्रत्येक प्रयास से कोई भी स्थिति या त्रुटि संदेश देखें।
बाएं नेविगेशन मेनू में Libraries विकल्प वह जगह है जहां आप उन लाइब्रेरी तक पहुंच सकते हैं जो अन्य लोगों ने लिखी हैं (या आपने लिखी हैं और कहीं और सहेजी हैं)। यह उपयोगी है यदि आपका कोई मित्र है जिसने पहले से ही एक सुविधा लिखी है जिसे आप Google Sheets या Google Docs में उपयोग करना चाहते हैं लेकिन आप उस पर अतिरिक्त सुविधाएं जोड़ना चाहते हैं।
उन लाइब्रेरी को अपने प्रोजेक्ट में जोड़ने के लिए आपको केवल Script ID की आवश्यकता है। आप इसे प्रोजेक्ट सेटिंग्स अनुभाग में पा सकते हैं, जिसे हम इस लेख के अंत में आपको ढूंढना दिखाएंगे।
Google Apps Script सेवाएं ऐड-ऑन
Services अनुभाग सबसे उपयोगी है। यह वह जगह है जहां आप अपने वर्तमान स्क्रिप्ट को अन्य Google सेवाओं के साथ एकीकृत कर सकते हैं जिनका आप उपयोग कर सकते हैं।
जब आप इसे चुनते हैं, तो आप Add a service विंडो खुली देखेंगे। उस सेवा तक नीचे स्क्रॉल करें जिसे आप अपने मौजूदा प्रोजेक्ट के ऐड-ऑन के रूप में उपयोग करना चाहते हैं।
उदाहरण के लिए, यदि आप अपने Google Analytics खाते से डेटा इस स्क्रिप्ट में खींचना चाहते हैं, तो आप Google Analytics API चुन सकते हैं, और Add चुन सकते हैं।
यदि आप उस नए ऐड-ऑन सेवा के लिए उपलब्ध फ़ंक्शन के बारे में विवरण ढूंढना चाहते हैं और उनका उपयोग कैसे करें, तो API के दाईं ओर तीन डॉट्स चुनें और See documentation चुनें।
यह Google Apps Script डॉक्यूमेंटेशन को एक नए टैब में खोलेगा, जो स्वचालित रूप से उस Google सेवा के अनुभाग पर खुलेगा।
अपने स्वयं के स्क्रिप्ट में उपयोग करने के लिए फ़ंक्शन सिंटैक्स, ट्यूटोरियल, और कोड उदाहरणों के लिए डॉक्यूमेंटेशन का अन्वेषण करें।
साथ ही, ध्यान दें कि आप डॉक्यूमेंटेशन के अन्य अनुभागों पर नेविगेट कर सकते हैं ताकि यह देखा जा सके कि आपके द्वारा मूल रूप से Apps Script कोड एडिटर खोलने पर उपयोग की जा रही सेवा के आधार पर आपके स्क्रिप्ट में कौन से सामान्य फ़ंक्शन उपलब्ध हैं।
उदाहरण के लिए, यदि आपने Google Sheets में एडिटर खोला, तो Google Sheets फ़ंक्शन के लिए डॉक्यूमेंटेशन मेनू में Sheets अनुभाग देखें जिनका उपयोग आप अपने स्क्रिप्ट में कर सकते हैं।
Apps Script ट्रिगर्स सेट अप करना और उपयोग करना
Google Apps Script में एक और उपयोगी विशेषता कई घटनाओं या शेड्यूल के आधार पर ट्रिगर सेट करने की क्षमता है।
अपने स्क्रिप्ट के लिए एक नया ट्रिगर कॉन्फ़िगर करने के लिए, दूर बाएं नेविगेशन मेनू से Triggers चुनें। खुलने वाली नई Triggers विंडो में, Add Trigger बटन चुनें।
Add Trigger विंडो में विकल्पों की एक लंबी सूची है जो आपको ठीक से अनुकूलित करने में मदद करती है कि आप अपने स्क्रिप्ट को कैसे और कब चलाना चाहते हैं।
नोट: इनमें से कई विकल्प उस सेवा पर निर्भर करते हैं जिसके लिए आप अपना स्क्रिप्ट लिख रहे हैं या उन APIs पर जो आपने जोड़े हैं।
अपना ट्रिगर सेट अप करने के लिए, आपको चुनना होगा:
- कौन सा फ़ंक्शन शुरू में लॉन्च करना है
- इवेंट स्रोत जैसे विशिष्ट समय, तिथि, या आपकी सेवा में एक घटना जैसे जब एक Google स्प्रेडशीट सेल बदलती है या एक दस्तावेज़ शुरू में खोला जाता है
- इवेंट प्रकार जैसे जब आपकी Google स्प्रेडशीट या दस्तावेज़ में कुछ खोला या संपादित किया जाता है, या तिथि या समय के लिए विशिष्ट सेटिंग
- सूचना आवृत्ति कि आप कितनी बार अपने स्क्रिप्ट की विफलता के बारे में अपडेट प्राप्त करना चाहते हैं
एक बार जब आप Save चुनते हैं, तो यदि यह पहली बार है जब आपने एक नया ट्रिगर सहेजा है तो आपको "Script authorization failed" संदेश दिखाई दे सकता है।
यह आमतौर पर तब ट्रिगर होता है जब आपके ब्राउज़र में पॉप-अप ब्लॉकर सक्षम होता है। यदि आप Google Chrome का उपयोग कर रहे हैं, तो बस लाल "X" के साथ छोटी विंडो आइकन चुनें। सेटिंग को Always allow pop-ups में बदलें और Done चुनें।
जब आप फिर से Save चुनते हैं, तो आपको अपने द्वारा लिखे गए स्क्रिप्ट को अपने Google खाते या Google Workspace के तहत चलाने के लिए अधिकृत करने की प्रक्रिया से गुजरना होगा।
सबसे पहले, वह Google खाता चुनें जिसके तहत आप अपने स्क्रिप्ट को चलाने की अनुमति देना चाहते हैं।
आपको एक चेतावनी दिखाई देगी कि आपके द्वारा लिखा गया कस्टम फ़ंक्शन या स्क्रिप्ट Google द्वारा "सत्यापित" नहीं है। यदि आप वह व्यक्ति हैं जिसने स्क्रिप्ट लिखी है, तो इससे कोई फर्क नहीं पड़ता और यह आपके अपने Google Account या Google Workspace के तहत चलाने के लिए सुरक्षित है।
इस चेतावनी को बायपास करने के लिए, बस Advanced चुनें और फिर नीचे Go to <project> (unsafe) लिंक चुनें।
अंत में, अनुमति विंडो में, अपने कस्टम फ़ंक्शन और स्क्रिप्ट को अपने Google खाते या Google Workspace के तहत चलाने की अनुमति देने के लिए Allow चुनें।
आपको इस प्रक्रिया को फिर से दोहराना नहीं पड़ेगा, केवल पहली बार जब आप अपने कस्टम Google Apps स्क्रिप्ट प्रोजेक्ट को सहेजते हैं या चलाते हैं।
अपनी Google Script ID तक पहुंचना
एक अंतिम नोट - आप अपने स्क्रिप्ट को दोस्तों या सहकर्मियों को प्रदान करना चाह सकते हैं ताकि वे या तो आपके स्क्रिप्ट का उपयोग कर सकें या इसे अपने स्वयं के स्क्रिप्ट में लाइब्रेरी के रूप में जोड़ सकें।
आप दूर बाएं नेविगेशन पेन में सेटिंग्स आइकन के तहत अपनी Script ID पा सकते हैं।
Script ID IDs अनुभाग के तहत, Script ID के दाईं ओर पाया जा सकता है।
जैसा कि आप देख सकते हैं, Google Apps Script एडिटर काफी सीधा है यदि आप जानते हैं कि जिस सुविधा का आप उपयोग करना चाहते हैं उस पर कैसे नेविगेट करना है। बस Google के Apps Script डॉक्यूमेंटेशन का अच्छी तरह से अध्ययन करना सुनिश्चित करें ताकि आप अपने स्क्रिप्ट लिखना और उपयोग करने के लिए उपलब्ध सभी फ़ंक्शन सीखना शुरू कर सकें।
