1. परिचय
Apps Script सीएलआई या clasp एक ऐसा टूल है जिससे आपको स्थानीय तौर पर Apps Script प्रोजेक्ट बनाने, उनमें बदलाव करने, और डिप्लॉय करने की सुविधा मिलती है. इससे आपको कमांड लाइन से, Sheets, Docs, Forms, और Slides जैसे प्रॉडक्ट के लिए वेब ऐप्लिकेशन और ऐड-ऑन बनाने और उन्हें पब्लिश करने की सुविधा मिलती है. आप Script.google.com का उपयोग करके या अपने कंप्यूटर पर स्थानीय रूप से, Apps Script को दो तरीकों से डेवलप कर सकते हैं. हम बाद में, Apps Script के लिए कमांड-लाइन टूल, clasp को इस्तेमाल करने का तरीका जानेंगे.
सुविधाएं
- स्थानीय रूप से डेवलप करें.
claspकी मदद से आप अपने कंप्यूटर पर कोड लिख सकते हैं और काम पूरा हो जाने पर उसे Apps Script में अपलोड कर सकते हैं. साथ ही, मौजूदा Apps Script प्रोजेक्ट डाउनलोड करके, उनमें बदलाव भी किया जा सकता है. कोड स्थानीय हो जाने के बाद, Apps Script प्रोजेक्ट पर काम करने के लिए, git जैसे अपने पसंदीदा डेवलपमेंट टूल का इस्तेमाल किया जा सकता है. - डिप्लॉयमेंट वर्शन मैनेज करें. अपने प्रोजेक्ट के एक से ज़्यादा डिप्लॉयमेंट बनाएं, अपडेट करें, और देखें.
- संरचना कोड.
clasp, script.google.com पर मौजूद आपके फ़्लैट प्रोजेक्ट को अपने-आप फ़ोल्डर में बदल देता है. उदाहरण के लिए:
# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs
# Locally:
├── tests/
│ ├─ slides.gs
│ └─ sheets.gs
आप इन चीज़ों के बारे में जानेंगे
इस कोडलैब से आपको पता चलेगा कि clasp का इस्तेमाल करके, तीन मुख्य गतिविधियां कैसे की जा सकती हैं:
- नए Apps Script प्रोजेक्ट बनाने का तरीका
- मौजूदा प्रोजेक्ट का क्लोन बनाने, उन्हें पुल करने, और पुश करने का तरीका
- अपनी स्क्रिप्ट के डिप्लॉयमेंट को कैसे मैनेज करें
2. शुरू करें
सीएलआई डाउनलोड किया जा रहा है
Apps Script CLI (clasp) के लिए, Node.js >= v6.0.0 को इंस्टॉल करना ज़रूरी है. Node.js को यहां इंस्टॉल करें.
नोड मिल जाने के बाद, सीएलआई को दुनिया भर में इंस्टॉल करें (उपनाम क्लिप):
npm i @google/clasp -g
3. लॉगिन
लॉगिन
आइए, कुत्ते का हुक इस्तेमाल करके देखते हैं! आपको बस clasp का निर्देश याद रखना चाहिए.
clasp
कमांड-लाइन टूल का इस्तेमाल शुरू करने से पहले, हमें लॉग इन करना होगा. इस निर्देश को चलाएं:
clasp login
या एसएसएच का इस्तेमाल करने पर:
clasp login --no-localhost
इस स्थिति में, आपको Google में लॉग इन करने के लिए कहा जाएगा. सीएलआई की मदद से बनाए गए सभी प्रोजेक्ट, इस Google खाते से जुड़े होते हैं.
4. नया प्रोजेक्ट बनाएं
स्टैंडअलोन प्रोजेक्ट बनाना
यहां दिए गए निर्देश की मदद से, एक स्टैंडअलोन Google Apps Script प्रोजेक्ट बनाएं:
mkdir clasp_codelab;
cd clasp_codelab;
clasp create --title "Clasp Codelab" --type standalone;
आपने अभी-अभी "clasp_codelab" फ़ोल्डर में Apps Script प्रोजेक्ट बनाया है!
मौजूदा प्रोजेक्ट का क्लोन बनाना (ज़रूरी नहीं)
Google स्लाइड ऐड-ऑन के लिए कंटेनर-सीमित स्क्रिप्ट बनाने की कोशिश करते हैं.
ऐसा करने के लिए, slides.google.com पर जाएं और एक नया प्रज़ेंटेशन बनाएं. प्रज़ेंटेशन के नाम को "clasp कोडलैब टेस्ट" में बदलें. हेडर में, टूल में जाकर, स्क्रिप्ट एडिटर... दबाएं.
इससे आपका Apps Script प्रोजेक्ट, script.google.com पर खुल जाएगा. किसी प्रोजेक्ट का क्लोन बनाने के लिए, हमें Script ID की ज़रूरत है. आपको यह आईडी, /projects/ के बाद Apps Script प्रोजेक्ट के यूआरएल में मिलेगा. वैल्यू को कॉपी करें और उसे यहां दिए गए कमांड में चिपकाएं:
clasp clone <scriptID>
आउटपुट ऐसा दिखना चाहिए...
अब आपने प्रोजेक्ट को अपनी मौजूदा डायरेक्ट्री में डाउनलोड कर लिया है. Code.gs (एक खाली फ़ंक्शन) का कॉन्टेंट देखने के लिए, अपने पसंदीदा एडिटर का इस्तेमाल करें.
5. पुलिंग और फ़ाइलें पुश करना
Script.google.com पर कोड में बदलाव करें
अब जब आप किसी प्रोजेक्ट का क्लोन बना सकते हैं, तो आइए फ़ाइलों को खींचने और पुश करने का तरीका जानें. हम आपको script.google.com के ज़रिए क्लाउड पर, बदलाव करने का तरीका बताएंगे. इसके अलावा, आपके कंप्यूटर को कंप्यूटर में ट्रांसफ़र करने का तरीका भी बताएंगे. आइए, स्क्रिप्ट को क्लाउड में खोलें:
clasp open
अब जबकि हम ऑनलाइन एडिटर पर काम कर रहे हैं, इसलिए हम ऑनलाइन कुछ कोड में बदलाव करेंगे जिसे हम बाद में clasp का इस्तेमाल करके फ़ेच करेंगे.
नई Apps Script फ़ाइल बनाने के लिए, एडिटर के बाईं ओर फ़ाइलें के बगल में मौजूद, फ़ाइल जोड़ें 
पर क्लिक करें > स्क्रिप्ट. utils/strings नाम डालें. नई बनाई गई फ़ाइल utils/strings.gs में, कोड को इनके साथ बदलें:
var world = "世界";
Code.gs में, मौजूदा कोड को इस कोड से बदलें:
function hello() {
Logger.log("Hello, " + world);
}
सबसे ऊपर, सेव करें 
पर क्लिक करें.
फ़ंक्शन को चलाने के लिए, एडिटर के सबसे ऊपर, फ़ंक्शन ड्रॉपडाउन सूची से hello चुनें और Run पर क्लिक करें.
वेलकम मैसेज, एक्ज़ीक्यूशन लॉग में सबसे नीचे दिखता है.
कोड में स्थानीय तौर पर बदलाव करें
आइए, उस कमांड लाइन पर वापस चलते हैं जहां हमने पिछली बार प्रोजेक्ट का क्लोन बनाया था. आप देख सकते हैं कि हमारा कोड अब ऑनलाइन एडिटर के साथ सिंक नहीं हो रहा है. इसे ठीक करने के लिए, आइए हमारे ऑनलाइन प्रोजेक्ट से कोड लेते हैं.
clasp pull
अब कोड पर वापस जाएं. आपको दिखेगा कि हमारे टूल के लिए एक फ़ोल्डर है. clasp सीएलआई, स्लैश वर्ण / को लोकल फ़ाइल सिस्टम के फ़ोल्डर में अपने-आप बदल देता है.
अपने पसंदीदा टेक्स्ट एडिटर में, util/strings.gs पर जाएं और वैरिएबल के नाम world को mondo से बदलें. साथ ही, world को mondo से बदलकर Code.gs को अपडेट करें. script.google.com पर अपडेट किया गया कोड अपडेट करने के लिए, वह कोड पुश करें जिसमें बदलाव किया गया है.
clasp push
यह बहुत आसान है! आपका कोड अब script.google.com पर अपडेट हो गया है.
6. वर्शन बनाना और डिप्लॉय करना
clasp की मदद से, वर्शन और डिप्लॉयमेंट को मैनेज किया जा सकता है. सबसे पहले, कुछ शब्दों के बारे में बात करना:
- वर्शन: एक "स्नैपशॉट" करने का विकल्प है. डिप्लॉयमेंट के लिए इस्तेमाल किए जाने वाले वर्शन को रीड-ओनली ब्रांच माना जा सकता है.
- डिप्लॉयमेंट: स्क्रिप्ट प्रोजेक्ट की पब्लिश की गई रिलीज़ (अक्सर ऐड-ऑन या वेब ऐप्लिकेशन के तौर पर). वर्शन नंबर ज़रूरी है.
चलिए, अपनी स्क्रिप्ट का वर्शन बनाते हैं:
clasp version "First version"
[version] की जगह बनाई गई लॉग की गई वर्शन स्ट्रिंग का इस्तेमाल करके, हम स्क्रिप्ट को डिप्लॉय कर सकते हैं:
clasp deploy 1 "First deployment"
clasp deploy निर्देश आपके मेनिफ़ेस्ट को देखता है और एक नए वर्शन का डिप्लॉयमेंट बनाता है. आपका कोड अब एक्ज़ीक्यूटेबल के तौर पर डिप्लॉय किया जा चुका है. डिप्लॉयमेंट गाइड में इसके बारे में ज़्यादा जानें.
7. हो गया!
हमें उम्मीद है कि Apps Script सीएलआई, Apps Script प्रोजेक्ट को मैनेज करने में आपकी मदद करने के लिए एक आसान टूल है.
हमने इन विषयों के बारे में बताया
- नए Apps Script प्रोजेक्ट बनाने का तरीका
- मौजूदा प्रोजेक्ट का क्लोन बनाने, पुश करने, और पाने का तरीका
- अपनी स्क्रिप्ट के डिप्लॉयमेंट को कैसे मैनेज करें
Clasp, GitHub पर उपलब्ध है. इसकी नई सुविधाओं और पैच का इस्तेमाल किया जा सकता है.
हमें इस बात का बेसब्री से इंतज़ार है कि Gemini का इस्तेमाल कैसे किया जाएगा!