Google Apps Script डैशबोर्ड

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 एडिटर से चलाया गया है.

एक्ज़ीक्यूशन बंद करना

लंबे समय तक चलने वाले ऐसे टास्क जिनकी प्रोसेस जारी है उन्हें Status फ़ील्ड में "Running" के तौर पर दिखाया जाता है. इन कार्रवाइयों को रोकने के लिए, प्रोजेक्ट की लाइन की दाईं ओर मौजूद, ज़्यादा > बंद करें पर क्लिक करें.

सेटिंग

बाईं ओर मौजूद नेविगेशन बार में सेटिंग को चुनकर, डैशबोर्ड की सेटिंग में बदलाव करें.

सेटिंग पैनल में, Apps Script API के लिए टॉगल होता है. इससे, एपीआई को आपके स्क्रिप्ट प्रोजेक्ट का ऐक्सेस दिया जा सकता है.

इस टॉगल को ऐक्सेस करने के लिए, सेटिंग पैनल में Google Apps Script API लेबल पर क्लिक करें. इससे एक नया पैनल खुलता है. इसमें चेतावनी वाला टेक्स्ट और टॉगल स्विच होता है. सुरक्षा के लिहाज़ से, आपके स्क्रिप्ट प्रोजेक्ट का ऐक्सेस डिफ़ॉल्ट रूप से बंद होता है. ऐक्सेस देने के बाद, तीसरे पक्ष का कोई भी ऐसा ऐप्लिकेशन जिसे आपने अनुमति दी है वह एपीआई का इस्तेमाल करके, आपकी स्क्रिप्ट और डिप्लॉयमेंट में बदलाव कर सकता है. सेटिंग पैनल में जाकर, इस ऐक्सेस को कभी भी बंद किया जा सकता है.

ज़्यादा जानकारी के लिए, Apps Script API ऐक्सेस करने से जुड़ी गाइड देखें.