Google Workspace में कस्टम मेन्यू का इस्तेमाल करना

स्क्रिप्ट, उपयोगकर्ता के इंटरफेस वाले एलिमेंट को जोड़कर, Google के कुछ प्रॉडक्ट को बढ़ा सकती हैं. इन एलिमेंट पर क्लिक करने से, Apps Script फ़ंक्शन लागू हो जाता है. सबसे सामान्य उदाहरण Google Docs, Sheets, Slides या Forms में मौजूद कस्टम मेन्यू आइटम से स्क्रिप्ट चलाना है. हालांकि, Google Sheets में इमेज और ड्रॉइंग पर क्लिक करके भी स्क्रिप्ट फ़ंक्शन ट्रिगर हो सकते हैं.

Google Docs, Sheets, Slides या Forms में अपनी पसंद के मुताबिक मेन्यू बनाना

Apps Script में Google Docs, Sheets, Slides या Forms में नए मेन्यू जोड़े जा सकते हैं. इसमें, मेन्यू आइटम, स्क्रिप्ट में मौजूद किसी फ़ंक्शन से जुड़ा होता है. (Google Forms में, कस्टम मेन्यू सिर्फ़ उस एडिटर को दिखता है जो फ़ॉर्म में बदलाव करने के लिए खोलता है, न कि ऐसे उपयोगकर्ता को जो जवाब देने के लिए फ़ॉर्म खोलता है.)

स्क्रिप्ट, मेन्यू सिर्फ़ तब बना सकता है, जब वह दस्तावेज़, स्प्रेडशीट या फ़ॉर्म के लिए बाउंड हो. जब उपयोगकर्ता किसी फ़ाइल को खोलता है, तब मेन्यू दिखाने के लिए, onOpen() फ़ंक्शन में मेन्यू कोड लिखें.

नीचे दिए गए उदाहरण में एक आइटम के साथ मेन्यू जोड़ने और उसके बाद विज़ुअल अलग करने वाला जोड़ने का तरीका बताया गया है. उसके बाद एक सब-मेन्यू जोड़ा गया है जिसमें दूसरा आइटम शामिल है. (ध्यान दें कि Google Sheets में नए वर्शन का इस्तेमाल न करने पर, आपको addMenu() सिंटैक्स का इस्तेमाल करना होगा. सब-मेन्यू का इस्तेमाल नहीं किया जा सकता.) जब उपयोगकर्ता किसी मेन्यू आइटम को चुनता है, तो उससे जुड़ा फ़ंक्शन एक चेतावनी डायलॉग खोलता है. अलग-अलग तरह के डायलॉग खोलने के बारे में ज़्यादा जानकारी के लिए, डायलॉग और साइडबार का गाइड देखें.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the second menu item!');
}

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

ध्यान दें: एडिटर ऐड-ऑन में मेन्यू आइटम भी हो सकते हैं, लेकिन इसमें खास नियमों का इस्तेमाल किया जाता है.

Google Sheets में क्लिक की जा सकने वाली इमेज और ड्रॉइंग

जब तक स्क्रिप्ट स्प्रेडशीट से बाइंड की जाती है, तब तक Google Sheets में मौजूद किसी इमेज या ड्रॉइंग को Apps Script फ़ंक्शन भी असाइन किया जा सकता है. नीचे दिए गए उदाहरण में इसे सेट अप करने का तरीका बताया गया है.

1. Google Sheets में, स्प्रेडशीट से जुड़ी स्क्रिप्ट बनाने के लिए, मेन्यू आइटम एक्सटेंशन > Apps Script चुनें.

2. स्क्रिप्ट संपादक में से कोई भी कोड हटा दें और नीचे दिए गए कोड में चिपकाएं.

     function showMessageBox() {
       Browser.msgBox('You clicked it!');
     }
   

3. Sheets पर वापस जाएं. इसके बाद, शामिल करें > इमेज या शामिल करें > ड्रॉइंग चुनकर कोई इमेज या ड्राइंग डालें.

4. इमेज या ड्रॉइंग डालने के बाद, उस पर क्लिक करें. सबसे ऊपर दाएं कोने में एक छोटा ड्रॉप-डाउन मेन्यू सिलेक्टर दिखेगा. उस पर क्लिक करें और स्क्रिप्ट असाइन करें चुनें.

5. दिखाई देने वाले संवाद बॉक्स में, उन Apps स्क्रिप्ट फ़ंक्शन का नाम लिखें जिसे आप चलाना चाहते हैं, बिना ब्रैकेट के — इस मामले में, showMessageBox. ठीक है पर क्लिक करें.

6. इमेज या ड्रॉइंग पर फिर से क्लिक करें. अब यह फ़ंक्शन काम करेगा.

Google Sites में किसी स्क्रिप्ट के लिंक

जब तक कि साइट पर स्क्रिप्ट बाउंड है, तब तक आप Google Sites में लिंक के लिए Apps Script फ़ंक्शन भी असाइन कर सकते हैं. इस सेट में, इसे सेट अप करने का तरीका बताया गया है.

1. Google साइट में, ज़्यादा > साइट मैनेज करें पर क्लिक करें.
2. साइडबार में, Apps Script पर क्लिक करें. इसके बाद, नई स्क्रिप्ट जोड़ें पर क्लिक करके, साइट से जुड़ी स्क्रिप्ट बनाएं.

3. स्क्रिप्ट एडिटर में मौजूद कोई भी कोड मिटाएं और नीचे दिए गए कोड में चिपकाएं, जब उपयोगकर्ता किसी लिंक पर क्लिक करेगा, तो उसे एक ईमेल भेजा जाएगा.

     function sitesLink() {
       var recipient = Session.getActiveUser().getEmail();
       GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
     }
   

4. Google साइट पर वापस जाएं और पेज में बदलाव करें. वह लेबल टाइप करें जो लिंक बन जाएगा, जैसे Click me, फिर टेक्स्ट को हाइलाइट करें और शामिल करें > लिंक चुनें.

5. एक डायलॉग बॉक्स दिखेगा. उसमें Apps Script पर क्लिक करें. इसके बाद, sitesLink फ़ंक्शन पर क्लिक करें. ठीक है पर क्लिक करें.

6. पेज में सबसे ऊपर मौजूद, सेव करें पर क्लिक करें.

7. पेज में जोड़े गए लिंक पर क्लिक करें.

8. एक डायलॉग बॉक्स दिखेगा और आपको बताएगा कि स्क्रिप्ट को अनुमति की ज़रूरत है. ठीक है पर क्लिक करें. इसके बाद, एक दूसरा डायलॉग बॉक्स खास Google सेवाओं के लिए अनुमति का अनुरोध करेगा. सूचना को ध्यान से पढ़ें और फिर अनुमति दें पर क्लिक करें. इसके बाद, बंद करें पर क्लिक करें.

9. अब जब स्क्रिप्ट को अनुमति मिल गई है, तो पेज में जोड़े गए लिंक पर फिर से क्लिक करें. अब यह फ़ंक्शन काम करेगा. खुद के भेजे हुए ईमेल को देखने के लिए, अपना ईमेल देखें.