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