प्रोजेक्ट मैनेज करना

इस सेक्शन में Apps Script API के उन तरीकों के बारे में खास जानकारी दी गई है जिनका इस्तेमाल आप अपने Apps Script प्रोजेक्ट बनाने, पढ़ने, उनमें बदलाव करने, और उनकी निगरानी करने के लिए कर सकते हैं. प्रोजेक्ट मैनेजमेंट के सैंपल पेज पर, एपीआई मैनेजमेंट के अनुरोधों के उदाहरण दिखते हैं. हर तरीके के लिए, रेफ़रंस दस्तावेज़ में उसे लागू करने से जुड़ी जानकारी दी गई है.

एपीआई के तरीके की खास जानकारी
प्रोजेक्ट बनाना	प्रोजेक्ट.create नतीजे: बिना प्रोजेक्ट फ़ाइल और डिफ़ॉल्ट प्रोजेक्ट मेनिफ़ेस्ट वाला एक बुनियादी और खाली प्रोजेक्ट बनाएं. विकल्प: प्रोजेक्ट का टाइटल दिया जा सकता है. स्क्रिप्ट के पैरंट के तौर पर काम करने के लिए, Google Docs, Google Sheets, Google Forms या Slides की फ़ाइल का Google Drive आईडी देकर, बाउंड स्क्रिप्ट भी बनाई जा सकती है.
प्रोजेक्ट का मेटाडेटा पढ़ना	Project.get नतीजे: यह एक Project ऑब्जेक्ट वापस लाता है, जो प्रोजेक्ट मेटाडेटा दिखाता है. इस डेटा में, प्रोजेक्ट का टाइटल, स्क्रिप्ट आईडी, उपयोगकर्ता बनाने का समय, बनाने का समय, और दूसरी जानकारी शामिल होती है.
प्रोजेक्ट का कॉन्टेंट पढ़ना	Project.getContent नतीजे: यह विकल्प File ऑब्जेक्ट का कलेक्शन दिखाता है, जो प्रोजेक्ट के हर कोड और एचटीएमएल फ़ाइल के लिए एक-एक होता है. इस सूची में, एक JSON फ़ाइल के तौर पर प्रोजेक्ट मेनिफ़ेस्ट भी शामिल है. फ़ाइल ऑब्जेक्ट में, फ़ाइल (File.source) का सोर्स कॉन्टेंट और अन्य मेटाडेटा शामिल होता है, जैसे कि फ़ाइल (File.functionSet) में मौजूद फ़ंक्शन की सूची. विकल्प: आपके पास यह तय करने का विकल्प होता है कि क्वेरी पैरामीटर की मदद से, कॉन्टेंट का कौनसा वर्शन उपलब्ध कराना है.
प्रोजेक्ट का कॉन्टेंट अपडेट करना	Project.updateContent नतीजे: किसी स्क्रिप्ट प्रोजेक्ट में फ़ाइल का कॉन्टेंट बदलता है. आप नए कॉन्टेंट को File ऑब्जेक्ट की कैटगरी के तौर पर उपलब्ध कराते हैं. इन File ऑब्जेक्ट में से एक ऑब्जेक्ट में, JSON टाइप होना चाहिए. साथ ही, यह स्क्रिप्ट प्रोजेक्ट के नए प्रोजेक्ट मेनिफ़ेस्ट की जानकारी भी होनी चाहिए. नया कॉन्टेंट, प्रोजेक्ट के HEAD वर्शन के तौर पर सेव किया जाता है. इसका इस्तेमाल तब किया जाता है, जब स्क्रिप्ट, ट्रिगर के तौर पर, स्क्रिप्ट एडिटर में, ऐड-ऑन झलक मोड में या डेवलपमेंट मोड में वेब ऐप्लिकेशन या Apps Script API के तौर पर काम करती है. ध्यान दें: स्क्रिप्ट प्रोजेक्ट का कॉन्टेंट अपडेट करते समय, पहले एक Project.getContent अनुरोध जारी किया जाता है, ताकि मौजूदा File के कलेक्शन को ऐक्सेस किया जा सके. इसके बाद, उन ऑब्जेक्ट को पसंद किया जाए. इसके बाद, प्रोजेक्ट.updateContent अनुरोध के लिए Files का इस्तेमाल इनपुट के तौर पर करें. चेतावनी: नया कॉन्टेंट, स्क्रिप्ट प्रोजेक्ट की सभी मौजूदा फ़ाइलों को बदल देता है. अनुरोध करने पर अपडेट नहीं की गई फ़ाइलें हटा दी जाती हैं.
प्रोजेक्ट की मेट्रिक पढ़ना	Project.getmetrics नतीजे: किसी प्रोजेक्ट की कुछ मेट्रिक पढ़ सकते हैं. इन मेट्रिक में, उपयोगकर्ताओं की संख्या, स्क्रिप्ट को पूरा करने की संख्या, स्क्रिप्ट को लागू करने की कुल संख्या, और अन्य जानकारी शामिल होती है. आपको जो जानकारी चाहिए उसके बारे में बताने के लिए, MetricType का इस्तेमाल करें. विकल्प: MetricsFilter का इस्तेमाल करके, नतीजों को खास डिप्लॉयमेंट या स्क्रिप्ट फ़ंक्शन तक सीमित करें. किसी MetricsIntervalConfig का इस्तेमाल करके आप एक खास मेट्रिक अंतराल तय कर सकते हैं.