शुरुआती जानकारी

Google Apps Script API की मदद से, Google Apps Script में स्क्रिप्ट बनाने, मैनेज करने, और उन्हें लागू करने की प्रोसेस को अपने-आप होने वाली प्रोसेस में बदला जा सकता है. प्रोग्राम के हिसाब से, Google Apps Script प्रोजेक्ट बनाए, उनमें बदलाव किए, और उन्हें डिप्लॉय किए जा सकते हैं. साथ ही, Apps Script फ़ंक्शन को रिमोटली (दूर से) लागू किया जा सकता है. इन कार्रवाइयों के लिए, Apps Script एडिटर या उसके यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना ज़रूरी होता है.

इस एपीआई का इस्तेमाल अक्सर इनके लिए किया जाता है:

  • Apps Script प्रोजेक्ट और डिप्लॉयमेंट बनाना और उन्हें मैनेज करना.
  • स्क्रिप्ट प्रोजेक्ट में फ़ंक्शन जोड़ना या उन्हें अपडेट करना.
  • Apps Script के फ़ंक्शन को अन्य ऐप्लिकेशन से लागू करना.
  • स्क्रिप्ट के लागू होने के लॉग और स्टेटस को मॉनिटर करें.

Apps Script API, Apps Script Execution API की जगह भी काम करता है और इसकी सुविधाओं को बेहतर बनाता है. Apps Script API का इस्तेमाल करके, Apps Script फ़ंक्शन को दूर से ही लागू किया जा सकता है. ठीक वैसे ही जैसे Execution API का इस्तेमाल किया जाता था.

अपने ऐप्लिकेशन में इस एपीआई का इस्तेमाल करने के लिए, आपको इसे इस्तेमाल करने की अनुमति देनी होगी.

अन्य ऐप्लिकेशन को अपनी स्क्रिप्ट मैनेज करने की अनुमति देने के लिए, आपको उन्हें ऐक्सेस देना होगा.

एपीआई के बारे में खास जानकारी

Apps Script API को कई संसाधनों में बांटा गया है. हर संसाधन का एक खास मकसद होता है. साथ ही, हर संसाधन के लिए अनुरोधों का एक सेट होता है. ये संसाधन यहां दिए गए हैं:

  • projects — यह स्क्रिप्ट प्रोजेक्ट का एक उदाहरण है. यह एपीआई, प्रोजेक्ट बनाने, पढ़ने, मॉनिटर करने, और उनमें बदलाव करने के तरीके उपलब्ध कराता है. इस संसाधन का इस्तेमाल करके, अपने प्रोजेक्ट की स्क्रिप्ट फ़ाइलों और मेटाडेटा को मैनेज करें.
  • projects.deployments — स्क्रिप्ट डिप्लॉयमेंट को दिखाने वाला विज़ुअल. यह एपीआई, स्क्रिप्ट प्रोजेक्ट के डिप्लॉयमेंट बनाने, उनकी सूची बनाने, उन्हें अपडेट करने, और मिटाने के तरीके उपलब्ध कराता है. अपनी स्क्रिप्ट को वेब ऐप्लिकेशन, ऐड-ऑन या एक्ज़ीक्यूटेबल के तौर पर उपलब्ध कराने के लिए, डिप्लॉयमेंट का इस्तेमाल करें.
  • projects.versions — यह स्क्रिप्ट प्रोजेक्ट के वर्शन को दिखाता है. यह एपीआई, प्रोजेक्ट के वर्शन बनाने और उन्हें पढ़ने के तरीके उपलब्ध कराता है. वर्शन का इस्तेमाल करके, अपने स्क्रिप्ट प्रोजेक्ट के अलग-अलग वर्शन को ट्रैक करें.
  • processes — यह स्क्रिप्ट फ़ंक्शन के एक्ज़ीक्यूशन को दिखाता है. एपीआई, मौजूदा प्रोसेस की सूची बनाने और उनके बारे में जानकारी इकट्ठा करने के तरीके उपलब्ध कराता है. जैसे, टाइप और मौजूदा स्थिति. scripts.run तरीके का इस्तेमाल करके शुरू की गई स्क्रिप्ट के एक्ज़ीक्यूशन को मॉनिटर करने के लिए, इस संसाधन का इस्तेमाल करें.
  • scripts — यह एंडपॉइंट, Apps Script फ़ंक्शन को रिमोट तरीके से चलाने के तरीके उपलब्ध कराता है. इस संसाधन का इस्तेमाल करके, अपने ऐप्लिकेशन से स्क्रिप्ट प्रोजेक्ट में फ़ंक्शन चलाएं.