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

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

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