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 प्रोजेक्ट के फ़ंक्शन के अलग-अलग एक्ज़ीक्यूशन देखे और मैनेज किए जा सकते हैं. हाल ही के एक्ज़ीक्यूशन का पूरा लॉग देखने के लिए, बाईं ओर मौजूद नेविगेशन में मेरे एक्ज़ीक्यूशन चुनें.

मेरे एक्ज़ीक्यूशन पैनल में, उन प्रोजेक्ट के सभी पिछले और चालू एक्ज़ीक्यूशन का लॉग दिखता है जिनके मालिक, एडिटर या दर्शक आप हैं. इस सूची में, उन प्रोजेक्ट में फ़ंक्शन के एक्ज़ीक्यूशन भी शामिल हो सकते हैं जिनका ऐक्सेस आपके पास नहीं है. हालांकि, अगर वे आपकी ओर से रन होते हैं, तो उन्हें इस सूची में शामिल किया जा सकता है. उदाहरण के लिए, इंस्टॉल और रन किए गए ऐड-ऑन. एक्ज़ीक्यूशन की सूची में, सिर्फ़ वह शुरुआती फ़ंक्शन दिखता है जिसे एक्ज़ीक्यूशन शुरू करने के लिए कॉल किया जाता है. इसमें, उस एक्ज़ीक्यूशन के दौरान कॉल किया गया हर फ़ंक्शन नहीं दिखता.

व्यू में सबसे ऊपर मौजूद फ़िल्टर का इस्तेमाल करके, यह कंट्रोल किया जा सकता है कि लॉग में किस तरह का एक्ज़ीक्यूशन रिपोर्ट किया जाए. लॉग की हर लाइन, एक एक्ज़ीक्यूशन को दिखाती है. शुरू होने का समय, अवधि, और स्थिति कॉलम में, उस एक्ज़ीक्यूशन के बारे में जानकारी दिखती है.

फ़ंक्शन कॉलम में, उस फ़ंक्शन का नाम दिखता है जिसने एक्ज़ीक्यूशन शुरू किया था. अगर आपके पास एक्ज़ीक्यूशन के स्क्रिप्ट वाले प्रोजेक्ट का ऐक्सेस नहीं है, लेकिन वह आपकी ओर से रन हुआ है, तो इस कॉलम में कोई नाम नहीं दिखेगा.

टाइप कॉलम में, यह दिखता है कि एक्ज़ीक्यूशन किसने शुरू किया. वैल्यू में ये शामिल हैं:

  • ऐड-ऑन. एक्ज़ीक्यूशन, किसी ऐड-ऑन से शुरू हुआ.
  • एक्ज़ीक्यूशन एपीआई. एक्ज़ीक्यूशन, Apps Script API के इनवोकेशन से शुरू हुआ.
  • टाइम ड्रिवन. एक्ज़ीक्यूशन, किसी टाइम इवेंट की वजह से हुआ.
  • ट्रिगर. एक्ज़ीक्यूशन, किसी ट्रिगर सोर्स से शुरू हुआ.
  • वेब ऐप्लिकेशन. एक्ज़ीक्यूशन, परिनियोजित वेब ऐप्लिकेशन से शुरू हुआ.
  • एडिटर. एक्ज़ीक्यूशन, Apps Script एडिटर से शुरू हुआ.

एक्ज़ीक्यूशन खत्म करना

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

सेटिंग

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

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

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

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