Apps Script डैशबोर्ड की मदद से, अपने Apps Script प्रोजेक्ट मैनेज किए जा सकते हैं और उन पर नज़र रखी जा सकती है. डैशबोर्ड का इस्तेमाल करके, इनमें से कोई भी काम किया जा सकता है:
- अपने मौजूदा Apps Script प्रोजेक्ट देखें और खोजें. इनमेंGoogle Workspace दस्तावेज़ों से जुड़ी बाउंड स्क्रिप्ट भी शामिल हैं.
- नए प्रोजेक्ट बनाएं.
- अपने प्रोजेक्ट के बारे में जानकारी देखें, जैसे कि OAuth के दायरे जिनका इस्तेमाल वह करता है.
- अपने स्क्रिप्ट प्रोजेक्ट की स्थिति और उनके इस्तेमाल को मॉनिटर करें.
- अपने प्रोजेक्ट और खाते के क्रेडेंशियल का इस्तेमाल करके चलने वाले अन्य प्रोजेक्ट के एक्ज़ीक्यूशन लॉग देखें.
- Apps Script API को टॉगल करके चालू या बंद करें. इससे, ऐप्लिकेशन को आपके स्क्रिप्ट प्रोजेक्ट के साथ इंटरैक्ट करने के लिए, एपीआई का इस्तेमाल करने की अनुमति दी जा सकती है या उसे रोका जा सकता है.
प्रोजेक्ट देखना और खोजना
Apps Script के डैशबोर्ड में, उन सभी स्क्रिप्ट प्रोजेक्ट की सूची होती है जिन्हें देखा या जिनमें बदलाव किया जा सकता है. डैशबोर्ड के बाईं ओर मौजूद नेविगेशन पैनल में, इन प्रोजेक्ट को इन कैटगरी में बांटा गया है:
- स्टार के निशान वाले प्रोजेक्ट. ऐसे प्रोजेक्ट जिनकी निगरानी की जा रही है.
- मेरे प्रोजेक्ट. वे प्रोजेक्ट जिनका मालिकाना हक आपके पास है.
- सभी प्रोजेक्ट. ऐसे प्रोजेक्ट जिनका मालिकाना हक आपके पास है या जिनमें बदलाव करने या देखने की अनुमति आपके पास है.
- मुझसे शेयर किया गया. ऐसे प्रोजेक्ट जिनका मालिकाना हक आपके पास नहीं है, लेकिन जिन्हें आपके साथ शेयर किया गया है.
- ट्रैश. ऐसे प्रोजेक्ट जिन्हें आपने Google Drive से हटाया है.
प्रोजेक्ट की सूचियों में प्रोजेक्ट का नाम, मालिक, और पिछली बार बदलाव करने की तारीख दिखती है. प्रोजेक्ट के नाम के बगल में मौजूद आइकॉन से पता चलता है कि प्रोजेक्ट स्टैंडअलोन प्रोजेक्ट है या बाउंड प्रोजेक्ट.
प्रोजेक्ट की जानकारी देखना
हर प्रोजेक्ट में एक व्यू शामिल होता है, ताकि प्रोजेक्ट के बारे में डेवलपर की जानकारी देखी जा सके. किसी प्रोजेक्ट की जानकारी देखने के लिए, प्रोजेक्ट की सूची में मौजूद लाइन पर क्लिक करें.
प्रोजेक्ट की जानकारी वाले व्यू में, प्रोजेक्ट के बारे में गड़बड़ी की दर, कार्रवाई, और उपयोगकर्ताओं से जुड़ा डेटा और ग्राफ़ दिखाए जाते हैं. साथ ही, प्रोजेक्ट का इस्तेमाल करने वाले किसी भी असली उपयोगकर्ता से किए गए OAuth स्कोप के अनुरोध भी दिखते हैं. डेटा मेट्रिक इस तरह से तय की जाती हैं:
- गड़बड़ी की दर. उन एक्सीक्यूशन का प्रतिशत जो बिना पकड़े गए अपवादों की वजह से नहीं चल पाए. इसकी गिनती के लिए, तय समयावधि में प्रोसेस नहीं किए जा सकने की कुल संख्या को, प्रोसेस नहीं किए जा सकने की कुल संख्या से भाग दिया जाता है.
- लागू करना. किसी प्रोजेक्ट को "रन" या लागू किए जाने की संख्या. किसी प्रोजेक्ट को चलाने के तरीके के बारे में ज़्यादा जानने के लिए, एक्ज़िक्यूशन टाइप देखें.
- उपयोगकर्ता. ऐसे यूनीक उपयोगकर्ता (खातों) की संख्या जिन्होंने तय समयावधि में, प्रोजेक्ट को एक या उससे ज़्यादा बार चलाया है. बिना पहचान वाले उपयोगकर्ताओं को ट्रैक नहीं किया जाता है. इसलिए, वे उपयोगकर्ताओं की संख्या या ग्राफ़ में नहीं दिखते.
आपके प्रोजेक्ट का हर डिप्लॉयमेंट, डेटा और ग्राफ़ के ऊपर मौजूद प्रोजेक्ट की जानकारी वाले पेज पर एक टैब के तौर पर दिखता है. आपके पास डिप्लॉयमेंट से जुड़ा डेटा देखने के लिए टैब चुनने का विकल्प होता है. सभी चुनने पर, प्रोजेक्ट के सभी डिप्लॉयमेंट और Apps Script कोड एडिटर से प्रोजेक्ट को चलाने वाले डेवलपर के रनिंग से जुड़ा डेटा दिखता है.
प्रोजेक्ट मॉनिटर करना
आपके पास ऐसे Apps Script प्रोजेक्ट का ऐक्सेस हो सकता है जिन्हें नियमित तौर पर इस्तेमाल या मैनेज नहीं किया जाता. प्रोजेक्ट को आसानी से ऐक्सेस करने के लिए बुकमार्क करने के लिए, उन पर स्टार का निशान लगाएं. स्टार के निशान वाले प्रोजेक्ट की मदद से, उन प्रोजेक्ट के इस्तेमाल और गड़बड़ी की दर के आंकड़े और ग्राफ़ को भी मॉनिटर किया जा सकता है.
किसी प्रोजेक्ट पर स्टार का निशान लगाने के लिए, प्रोजेक्ट की लाइन की दाईं ओर, ज़्यादा > स्टार का निशान जोड़ें पर क्लिक करें. प्रोजेक्ट की जानकारी देखते समय, ज़्यादा पर क्लिक करके भी किसी प्रोजेक्ट को स्टार किया जा सकता है.
बाएं नेविगेशन में, बुकमार्क किए गए प्रोजेक्ट देखने के लिए स्टार के निशान वाले प्रोजेक्ट चुने जा सकते हैं. पिछले सात दिनों में, स्टार के निशान वाले सभी प्रोजेक्ट के लिए, इससे जुड़े ग्राफ़ देखने के लिए, पेज पर सबसे ऊपर मौजूद गड़बड़ी की दर, कार्रवाई या उपयोगकर्ता स्कोरकार्ड पर क्लिक करें.
किसी प्रोजेक्ट से स्टार का निशान हटाया जा सकता है. इसके लिए, प्रोजेक्ट की लाइन में मौजूद ज़्यादा पर क्लिक करें. इसके बाद, स्टार का निशान हटाएं को चुनें.
एक्सीक्यूशन मैनेज करना
Apps Script प्रोजेक्ट के फ़ंक्शन के अलग-अलग रन को देखने और मैनेज करने के लिए, Apps Script डैशबोर्ड का इस्तेमाल किया जा सकता है. हाल ही में किए गए टास्क का पूरा लॉग देखने के लिए, बाईं ओर मौजूद नेविगेशन पैनल में मेरे टास्क आइटम चुनें.
मेरे एक्सीक्यूशन पैनल में, डिफ़ॉल्ट रूप से उन सभी प्रोजेक्ट के लिए, पहले और फ़िलहाल चल रहे सभी एक्सीक्यूशन का लॉग दिखता है जिनका मालिकाना हक, एडिटर या दर्शक के तौर पर आपके पास है. इस सूची में, उन प्रोजेक्ट में फ़ंक्शन के इस्तेमाल की जानकारी भी शामिल हो सकती है जिनका ऐक्सेस आपके पास नहीं है. ऐसा तब होता है, जब वे प्रोजेक्ट आपकी ओर से चलाए जाते हैं. उदाहरण के लिए, ऐसे ऐड-ऑन जिन्हें आपने इंस्टॉल और चलाया है. एक्ज़ीक्यूशन सूची सिर्फ़ वह शुरुआती फ़ंक्शन दिखाती है जिसे एक्ज़ीक्यूट करना शुरू करने के लिए कहा जाता है. यह उस फ़ंक्शन को नहीं दिखाता जिसे उस दौरान कॉल किया गया था.
व्यू में सबसे ऊपर मौजूद फ़िल्टर का इस्तेमाल करके, यह कंट्रोल किया जा सकता है कि लॉग में किस तरह के एक्सीक्यूशन की रिपोर्ट की जाए. लॉग की हर पंक्ति, एक बार की गई प्रोसेस को दिखाती है. शुरू होने का समय, अवधि, और स्थिति कॉलम, उस एक्सीक्यूशन के बारे में जानकारी दिखाते हैं.
फ़ंक्शन कॉलम उस फ़ंक्शन का नाम दिखाता है जिसने एक्ज़ीक्यूशन शुरू किया. अगर आपके पास, टास्क को लागू करने के लिए इस्तेमाल की गई स्क्रिप्ट के प्रोजेक्ट का ऐक्सेस नहीं है, लेकिन वह आपकी ओर से चलाया गया है, तो इस कॉलम में कोई नाम नहीं दिखेगा.
टाइप कॉलम से पता चलता है कि ट्रांज़ैक्शन किस वजह से हुआ. वैल्यू में ये शामिल हैं:
- ऐड-ऑन. ऐक्शन, ऐड-ऑन से शुरू हुआ था.
- एक्ज़िक्यूशन एपीआई. Apps Script API को शुरू करने की वजह से, कोड एक्ज़ीक्यूट होने की प्रोसेस शुरू हुई.
- समय के हिसाब से. यह प्रोग्राम, टाइम इवेंट की वजह से लागू हुआ.
- ट्रिगर. एक्ज़ीक्यूशन किसी ट्रिगर सोर्स से शुरू हुआ.
- Webapp. डिप्लॉय किए गए किसी वेब ऐप्लिकेशन से एक्ज़ीक्यूशन शुरू हुआ.
- एडिटर. स्क्रिप्ट को Apps Script एडिटर से चलाया गया था.
एक्ज़ीक्यूशन को खत्म करना
लंबे समय तक चलने वाले ऐसे एक्सीक्यूशन जिनकी प्रोसेस अभी जारी है उनकी स्थिति "चल रहा है" के तौर पर दिखती है. इन प्रोसेस को बंद करने के लिए, प्रोजेक्ट पंक्ति की दाईं ओर, ज़्यादा > बंद करें पर क्लिक करें.
सेटिंग
आप बाएं नेविगेशन में सेटिंग चुनकर, अपनी डैशबोर्ड सेटिंग में बदलाव कर सकते हैं.
सेटिंग पैनल में, Apps Script API के लिए टॉगल मौजूद होता है. इससे, एपीआई को अपने स्क्रिप्ट प्रोजेक्ट का ऐक्सेस दिया जा सकता है.
इस टॉगल को ऐक्सेस करने के लिए, सेटिंग पैनल में Google Apps Script API लेबल पर क्लिक करें. इससे एक नया पैनल खुलता है, जिसमें चेतावनी वाला टेक्स्ट और एक टॉगल स्विच होता है. सुरक्षा के लिहाज़ से, आपके स्क्रिप्ट प्रोजेक्ट का ऐक्सेस डिफ़ॉल्ट रूप से बंद कर दिया जाता है. ऐक्सेस देने के बाद, तीसरे पक्ष का कोई भी ऐप्लिकेशन, आपकी स्क्रिप्ट और डिप्लॉयमेंट में बदलाव करने के लिए एपीआई का इस्तेमाल कर सकता है. सेटिंग पैनल में जाकर, इस ऐक्सेस को कभी भी वापस लिया जा सकता है.
ज़्यादा जानकारी के लिए, Apps Script API के ऐक्सेस की गाइड देखें.