क्लैस्प वाले कमांड लाइन इंटरफ़ेस का इस्तेमाल करना

Apps Script एडिटर के बजाय, अपने टर्मिनल से Apps Script प्रोजेक्ट डेवलप और मैनेज करने के लिए, clasp नाम के ओपन-सोर्स टूल का इस्तेमाल किया जा सकता है.

clasp कोडलैब में, clasp की सभी सुविधाओं के बारे में खास जानकारी मिलती है.

सुविधाएं

स्थानीय तौर पर बनाना

clasp की मदद से, अपने Apps Script प्रोजेक्ट स्थानीय तौर पर डेवलप किए जा सकते हैं. अपने कंप्यूटर पर कोड लिखा जा सकता है और काम पूरा होने पर, उसे 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 को Node.js में लिखा गया है और इसे npm टूल के ज़रिए डिस्ट्रिब्यूट किया जाता है. clasp का इस्तेमाल करने से पहले, आपके पास Node.js का 4.7.4 या उसके बाद का वर्शन इंस्टॉल होना चाहिए. Node.js इंस्टॉल करने के लिए, एडमिन के अधिकारों की ज़रूरत होती है.

इंस्टॉल करना

Node.js इंस्टॉल करने के बाद, clasp को इंस्टॉल करने के लिए, यहां दिए गए npm निर्देश का इस्तेमाल किया जा सकता है:

npm install @google/clasp -g

इंस्टॉल होने के बाद, अपने कंप्यूटर पर किसी भी डायरेक्ट्री से clasp कमांड का इस्तेमाल किया जा सकता है.

clasp का इस्तेमाल करना

कमांड लाइन से कई तरह के टास्क मैनेज करने के लिए, clasp का इस्तेमाल किया जा सकता है. इस सेक्शन में, clasp का इस्तेमाल करके डेवलप करते समय किए जाने वाले सामान्य ऑपरेशन के बारे में बताया गया है.

लॉगिन

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

clasp login

लॉगआउट करें

यह कमांड, कमांड-लाइन टूल से लॉग आउट करता है. clasp का इस्तेमाल जारी रखने से पहले, आपको Google से फिर से पुष्टि करने के लिए, clasp login का इस्तेमाल करके फिर से लॉगिन करना होगा.

clasp logout

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

यह कमांड, मौजूदा डायरेक्ट्री में एक नई स्क्रिप्ट बनाता है. इसमें स्क्रिप्ट का टाइटल भी दिया जा सकता है.

clasp create [scriptTitle]

यह कमांड, मौजूदा डायरेक्ट्री में दो फ़ाइलें भी बनाता है:

  • स्क्रिप्ट आईडी को सेव करने वाली .clasp.json फ़ाइल.
  • प्रोजेक्ट का मेटाडेटा शामिल करने वाली appsscript.json प्रोजेक्ट मेनिफ़ेस्ट फ़ाइल.

किसी मौजूदा प्रोजेक्ट का क्लोन बनाना

यह कमांड, मौजूदा डायरेक्ट्री में मौजूद किसी प्रोजेक्ट का क्लोन बनाता है. स्क्रिप्ट को आपके Google खाते से बनाया गया हो या उससे शेयर किया गया हो. आपको जिस स्क्रिप्ट प्रोजेक्ट को क्लोन करना है उसका स्क्रिप्ट आईडी देकर, प्रोजेक्ट के बारे में बताया जाता है.

प्रोजेक्ट का स्क्रिप्ट आईडी ढूंढने के लिए, यह तरीका अपनाएं:

  1. Apps Script प्रोजेक्ट खोलें.
  2. बाईं ओर, प्रोजेक्ट सेटिंग पर क्लिक करें.
  3. आईडी में जाकर, स्क्रिप्ट आईडी कॉपी करें.

     clasp clone <scriptId>
    

स्क्रिप्ट प्रोजेक्ट डाउनलोड करना

यह कमांड, Google Drive से Apps Script प्रोजेक्ट को आपके कंप्यूटर के फ़ाइल सिस्टम में डाउनलोड करता है.

clasp pull

स्क्रिप्ट प्रोजेक्ट अपलोड करना

यह निर्देश, स्क्रिप्ट प्रोजेक्ट की सभी फ़ाइलों को आपके कंप्यूटर से Google Drive पर अपलोड करता है.

clasp push

प्रोजेक्ट के वर्शन की सूची

यह कमांड, स्क्रिप्ट प्रोजेक्ट के हर वर्शन की संख्या और जानकारी दिखाता है.

clasp versions

पब्लिश किए गए प्रोजेक्ट को डिप्लॉय करना

स्क्रिप्ट प्रोजेक्ट को वेब ऐप्लिकेशन, ऐड-ऑन या एक्सीक्यूटेबल के तौर पर डिप्लॉय किया जा सकता है. स्क्रिप्ट एडिटर में, प्रोजेक्ट के मेनिफ़ेस्ट में या clasp का इस्तेमाल करके, डिप्लॉयमेंट बनाए जा सकते हैं.

clasp के साथ किसी प्रोजेक्ट को डिप्लॉय करने के लिए, पहले Apps Script प्रोजेक्ट का ऐसा वर्शन बनाएं जिसे बदला न जा सके. वर्शन, स्क्रिप्ट प्रोजेक्ट का "स्नैपशॉट" होता है. यह सिर्फ़ पढ़ने के लिए उपलब्ध शाखा वाली रिलीज़ जैसा ही होता है.

clasp version [description]

यह कमांड, नए वर्शन का नंबर दिखाता है. इस नंबर का इस्तेमाल करके, अपने प्रोजेक्ट के इंस्टेंस को डिप्लॉय और अनडिप्लॉय किया जा सकता है:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

यह कमांड, किसी मौजूदा डिप्लॉयमेंट को नए वर्शन और जानकारी के साथ अपडेट करता है:

clasp redeploy <deploymentId> <version> <description>

डिप्लॉयमेंट की सूची बनाना

यह कमांड, स्क्रिप्ट प्रोजेक्ट के डिप्लॉयमेंट आईडी, वर्शन, और उनके ब्यौरे दिखाता है.

clasp deployments

प्रोजेक्ट को Apps Script एडिटर में खोलना

यह कमांड, Apps Script एडिटर में स्क्रिप्ट प्रोजेक्ट खोलता है. एडिटर, आपके डिफ़ॉल्ट वेब ब्राउज़र में एक नए टैब के तौर पर लॉन्च होता है.

clasp open

clasp ओपन-सोर्स प्रोजेक्ट में योगदान दिया हो

GitHub पर clasp में योगदान दें.