এডিটর অ্যাড-অনগুলির জন্য কাস্টম মেনু, এডিটর অ্যাড-অনগুলির জন্য কাস্টম মেনু

প্রকাশিত সম্পাদক অ্যাড-অনগুলি তাদের সম্পাদকের এক্সটেনশন মেনুর অধীনে কাস্টম মেনু আইটেম তৈরি করতে পারে। আপনি Ui.createAddonMenu() পদ্ধতি ব্যবহার করে একটি অ্যাড-অন মেনু সন্নিবেশ করতে পারেন এবং Menu.addItem() পদ্ধতি ব্যবহার করে এতে আইটেম যুক্ত করতে পারেন। মেনুগুলি সাধারণত অ্যাড-অনের onOpen(e) পদ্ধতিতে তৈরি করা হয়।

আপনি ব্যবহারকারীর ইন্টারঅ্যাকশন বা অ্যাড-অনের অবস্থার উপর ভিত্তি করে পরিবর্তিত ডায়নামিক মেনু তৈরি করতে পারেন। তবে, ব্যবহারকারীর দ্বারা অ্যাড-অন অনুমোদিত হওয়ার আগে অ্যাড-অনগুলিকে একটি প্রাথমিক মেনু তৈরি করতে হবে। এই কারণে, onOpen(e) এ মেনু তৈরি করার আগে আপনাকে অ্যাড-অনের অনুমোদন মোড পরীক্ষা করতে হবে। অ্যাড-অনটি ScriptApp.AuthMode.NONE এ থাকাকালীন অনুমোদনের প্রয়োজন হয় এমন কোনও পদক্ষেপ নেওয়ার চেষ্টা করবেন না (যেমন স্ক্রিপ্ট Properties পরীক্ষা করা)। অনুমোদন মোড এবং জীবনচক্র সম্পর্কে আরও বিস্তারিত জানার জন্য অনুমোদন জীবনচক্র দেখুন।

নিম্নলিখিত উদাহরণে বিভিন্ন অনুমোদন মোডের জন্য একটি গতিশীল অ্যাড-অন মেনু কীভাবে তৈরি করতে হয় তা দেখানো হয়েছে:

function onOpen(e) {
  var menu = SpreadsheetApp.getUi().createAddonMenu(); // Or DocumentApp or SlidesApp or FormApp.
  if (e && e.authMode == ScriptApp.AuthMode.NONE) {
    // Add a normal menu item (works in all authorization modes).
    menu.addItem('Start workflow', 'startWorkflow');
  } else {
    // Add a menu item based on properties (doesn't work in AuthMode.NONE).
    var properties = PropertiesService.getDocumentProperties();
    var workflowStarted = properties.getProperty('workflowStarted');
    if (workflowStarted) {
      menu.addItem('Check workflow status', 'checkWorkflow');
    } else {
      menu.addItem('Start workflow', 'startWorkflow');
    }
    // Record analytics.
    UrlFetchApp.fetch('http://www.example.com/analytics?event=open');
  }
  menu.addToUi();
}