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

इस सेक्शन में, 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 का कलेक्शन वापस पाएं. इसके बाद, उन ऑब्जेक्ट में ज़रूरी बदलाव करें. फिर, projects.updateContent अनुरोध के लिए, इन File को इनपुट के तौर पर इस्तेमाल करें. चेतावनी: नया कॉन्टेंट, स्क्रिप्ट प्रोजेक्ट में मौजूद सभी फ़ाइलों की जगह ले लेता है. अनुरोध से अपडेट न की गई फ़ाइलें हटा दी जाती हैं.
प्रोजेक्ट की मेट्रिक पढ़ना	projects.getMetrics नतीजे: किसी प्रोजेक्ट के बारे में कुछ मेट्रिक पढ़ी जाती हैं. इन मेट्रिक में उपयोगकर्ताओं की संख्या, कुल एक्ज़ीक्यूशन की संख्या, एक्ज़ीक्यूशन में हुई कुल गड़बड़ियों की संख्या, और अन्य जानकारी शामिल होती है. अनुरोध की जा रही जानकारी तय करने के लिए, MetricType का इस्तेमाल करें. विकल्प: MetricsFilter का इस्तेमाल करके, नतीजों को खास परिनियोजन या स्क्रिप्ट फ़ंक्शन तक सीमित किया जा सकता है. MetricsFilter MetricsIntervalConfig का इस्तेमाल करके, मेट्रिक का कोई खास इंटरवल भी तय किया जा सकता है.