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

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

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