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

इस सेक्शन में, 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 का इस्तेमाल करके, किसी खास मेट्रिक इंटरवल को भी तय किया जा सकता है.