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