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

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp 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, SlidesApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp 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 Script फ़ंक्शन का नाम लिखें जिसे आपको ब्रैकेट के बिना चलाना है — इस मामले में, showMessageBox. ठीक है पर क्लिक करें.

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