निर्देश देने के लिए कमांड लाइन इंटरफ़ेस

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

clasp कोडलैब (कोड बनाना सीखना) से 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, 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 स्क्रिप्ट प्रोजेक्ट संग्रहित किए जाते हैं.

clasp login

लॉगआउट करें

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

clasp logout

ऐप्लिकेशन का नया स्क्रिप्ट प्रोजेक्ट बनाना

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

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 प्रोजेक्ट का एक बदला न जा सकने वाला वर्शन बनाएं. वर्शन, स्क्रिप्ट प्रोजेक्ट का "snapshot" होता है और यह रीड ओनली ब्रांच किए गए रिलीज़ की तरह होता है.

clasp version [description]

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

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

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

clasp redeploy <deploymentId> <version> <description>

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

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

clasp deployments

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

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

clasp open

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

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