Google Workspace-এ কাস্টম মেনু

স্ক্রিপ্টগুলি ব্যবহারকারী-ইন্টারফেস উপাদান যোগ করে নির্দিষ্ট কিছু Google পণ্যকে প্রসারিত করতে পারে, যা ক্লিক করলে, একটি Google Apps Script ফাংশন কার্যকর করে। সবচেয়ে সাধারণ উদাহরণ হল Google Docs, Google Sheets, Google Slides, অথবা Google Forms-এ একটি কাস্টম মেনু আইটেম থেকে একটি স্ক্রিপ্ট চালানো, তবে Sheets-এ ছবি এবং অঙ্কনে ক্লিক করেও স্ক্রিপ্ট ফাংশনগুলি ট্রিগার করা যেতে পারে।

ডক্স, শিট, স্লাইড বা ফর্মে কাস্টম মেনু

অ্যাপস স্ক্রিপ্ট ডক্স, শিটস, স্লাইডস, অথবা ফর্মে নতুন মেনু যোগ করতে পারে, প্রতিটি মেনু আইটেম স্ক্রিপ্টের একটি ফাংশনের সাথে সংযুক্ত থাকে। (ফর্মে, কাস্টম মেনু শুধুমাত্র একজন সম্পাদকের কাছে দৃশ্যমান হয় যিনি ফর্মটি পরিবর্তন করার জন্য খোলেন, প্রতিক্রিয়া জানাতে ফর্মটি খোলেন এমন কোনও ব্যবহারকারীর কাছে নয়।)

শুধুমাত্র বাউন্ড স্ক্রিপ্টই মেনু তৈরি করতে পারে। ব্যবহারকারী যখন কোনও ফাইল খোলেন তখন মেনু প্রদর্শনের জন্য, একটি onOpen ফাংশনের মধ্যে মেনু কোডটি লিখুন।

নিচের উদাহরণে দেখানো হয়েছে কিভাবে একটি আইটেম সহ একটি মেনু যোগ করতে হয়, তারপরে একটি ভিজ্যুয়াল সেপারেটর , তারপর একটি সাব-মেনু যেখানে অন্য একটি আইটেম থাকে। ব্যবহারকারী যখন যেকোনো একটি মেনু আইটেম নির্বাচন করেন, তখন সংশ্লিষ্ট ফাংশনটি একটি সতর্কতা ডায়ালগ খোলে। আপনি যে ধরণের ডায়ালগ খুলতে পারেন সে সম্পর্কে আরও তথ্যের জন্য, ডায়ালগ এবং সাইডবারের নির্দেশিকা দেখুন।

function onOpen() {
  const 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 ফাংশনটি লিখতে পারেন যাতে ভবিষ্যতে কোনও নির্দিষ্ট বৈশিষ্ট্য সেট করা থাকলে মেনুটি এড়িয়ে যেতে পারেন।

এডিটর অ্যাড-অনগুলিতেও মেনু আইটেম থাকতে পারে, তবে সেগুলি কীভাবে সংজ্ঞায়িত করা হয় তার জন্য বিশেষ নিয়ম ব্যবহার করুন।

Sheets-এ ক্লিকযোগ্য ছবি এবং অঙ্কন

আপনি Sheets-এ একটি ছবি বা অঙ্কনে একটি Apps Script ফাংশনও বরাদ্দ করতে পারেন, যদি স্ক্রিপ্টটি স্প্রেডশিটের সাথে আবদ্ধ থাকে। নিম্নলিখিত উদাহরণটি এটি কীভাবে সেট আপ করবেন তা দেখায়।

1. পত্রকগুলিতে, স্প্রেডশিটের সাথে আবদ্ধ একটি স্ক্রিপ্ট তৈরি করতে মেনু আইটেম এক্সটেনশন > অ্যাপস স্ক্রিপ্ট নির্বাচন করুন।
2. স্ক্রিপ্ট এডিটরে যেকোনো কোড মুছে ফেলুন এবং নীচের কোডটি পেস্ট করুন।

function showMessageBox() {
  SpreadsheetApp.getUi().alert('You clicked it!');
}

1. Sheets-এ ফিরে যান এবং Insert > Image অথবা Insert > Drawing নির্বাচন করে একটি ছবি বা অঙ্কন সন্নিবেশ করুন।
2. ছবি বা অঙ্কন সন্নিবেশ করার পরে, এটিতে ক্লিক করুন। উপরের ডানদিকের কোণায় একটি ছোট ড্রপ-ডাউন মেনু নির্বাচক প্রদর্শিত হবে। এটিতে ক্লিক করুন এবং "অ্যাসাইন স্ক্রিপ্ট" নির্বাচন করুন।
3. যে ডায়ালগটি প্রদর্শিত হবে, তাতে বন্ধনী ছাড়াই আপনি যে অ্যাপস স্ক্রিপ্ট ফাংশনটি চালাতে চান তার নাম টাইপ করুন — এই ক্ষেত্রে, showMessageBox । OK এ ক্লিক করুন।
4. ছবি বা অঙ্কনটিতে আবার ক্লিক করুন। ফাংশনটি এখন কার্যকর হবে।

স্ক্রিপ্ট এক্সিকিউশন শুধুমাত্র ওয়েব ব্রাউজারে ছবি বা অঙ্কনে ক্লিক করলেই শুরু হয়। মোবাইলে ছবি বা অঙ্কনে ক্লিক করলে স্ক্রিপ্ট এক্সিকিউশন হয় না।