Google Apps Script Editor: শুরু করার জন্য আপনার যা কিছু জানার প্রয়োজন

আপনি যদি Google সার্ভিস যেমন Google Docs, Google Sheets, Google Analytics, Gmail, এবং অন্যান্য ব্যবহার করেন, তবে আপনি Google Apps Script ব্যবহার করে সেই সার্ভিসগুলোর সাথে সংযোগ এবং অটোমেট করতে পারেন।

Google Apps Script-কে Microsoft-এর VBA স্ক্রিপ্টের Google ভার্সন হিসেবে ভাবুন। ঠিক যেভাবে আপনি VBA-র সাথে Microsoft Word এবং Excel-এ অ্যাকশন এবং টাস্ক অটোমেট করতে পারেন বা ম্যাক্রো কাস্টমাইজ করতে পারেন, ঠিক তেমনি আপনি Google সার্ভিস জুড়ে টাস্ক এবং অ্যাকশন অটোমেট করতে পারেন। Sheets এবং Docs-এর মত সার্ভিসে, আপনি আপনার নিজস্ব কাস্টম মেনুও লিখতে পারেন।

এই আর্টিকেলে আপনি শিখবেন কীভাবে আপনার বিভিন্ন Google সার্ভিসে Apps Script এক্সেস এবং এনাবল করবেন, Apps Script Editor কীভাবে নেভিগেট করবেন, এবং সার্ভিসগুলোর সাথে কীভাবে সংযোগ করবেন। আপনি নির্দিষ্ট স্ক্রিপ্ট ফাংশন শিখবেন না, কিন্তু Google-র দুর্দান্ত ডকুমেন্টেশন এবং Apps Script টিউটোরিয়াল আছে Apps Script লিখা শেখার জন্য।

Google Apps Script Editor কীভাবে এক্সেস করবেন

আপনি অনেক Google সার্ভিসের ভিতর থেকে Google Apps Script কোড এডিটর খুলতে পারেন। উদাহরণস্বরূপ, Google Sheets-এ Extensions মেনুর ভিতরে Apps Script পাবেন।

অন্যান্য সার্ভিসে, আপনি নিম্নলিখিত উপায়ে Google Apps Script এডিটর খুলতে পারেন:

• Google Docs: Tools মেনুর Script editor সিলেক্ট করুন।
• Google Slides: Tools মেনুর Script editor সিলেক্ট করুন।
• Google Forms: তিন-ডট মেনুর Script editor সিলেক্ট করুন।
• Google Drive: যেকোনো খালি জায়গায় রাইট-ক্লিক করুন, More সিলেক্ট করুন, এবং Google Apps Script সিলেক্ট করুন।

এই যেকোনো পদ্ধতি ব্যবহার করলে, আপনি Apps Script কোড এডিটর একটি নতুন ট্যাবে খুলতে দেখবেন। এটি वो উইন্ডো যেখানে আপনি আপনার সম্পূর্ণ স্ক্রিপ্ট বানানোর ফাংশনগুলো লিখবেন। ডিফল্টভাবে, আপনি একটি খালি ফাংশন দেখবেন যার নাম myFunction() যা আপনার কোড দিয়ে ভরার জন্য প্রস্তুত।

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

আপনি কোড এডিটরে নেভিগেট করার সাথে সাথে, আপনি এই সেকশনে ফিরে আসতে পারেন বাম নেভিগেশন পেনের Editor উইন্ডোতে Code.gs সিলেক্ট করে। অন্যান্য উপলব্ধ উইন্ডো देखने জন্য, ফার লeft পেনের আইকনে হোভার করুন এবং মেইন নেভিগেশন পেন খুলবে।

Overview সেকশন হলো যেখানে আপনি আপনার স্ক্রিপ্টের পরিসংখ্যান পাবেন যেমন কতগুলো এরর হয়েছে, কতবার এটি এক্সিকিউট হয়েছে, এবং আরও অনেক কিছু।

আমরা Google Apps Script এডিটর의 অন্যান্য সেকশনগুলো নিচে প্রতিটি সেকশনে কভার করব।

Google Apps Script Editor নেভিগেট করা

আপনি কোড এডিটরে এডিট করার সাথে সাথে, ডিস্ক (Save) আইকন ঘন ঘন সিলেক্ট করা ভালো যাতে আপনি আপনার কাজ হারাবেন না।

একবার সেভ করলে, আপনি অন্যান্য মেনু অপশন জ্বলতে দেখবেন।

এগুলোর মধ্যে রয়েছে:

• Run: আপনার সম্পূর্ণ স্ক্রিপ্ট শুরু থেকে শেষ পর্যন্ত চালানোর চেষ্টা করুন।
• Debug: আপনার স্ক্রিপ্ট এক লাইন এক লাইন Стеপ থ্রু করুন।
• Function dropdown: আপনার তৈরি করা প্রতিটি ফাংশন ব্রাউজ এবং নেভিগেট করুন।
• Execution log: আপনার স্ক্রিপ্ট চালানোর প্রতিটি চেষ্টার স্ট্যাটাস বা এরর মেসেজ দেখুন।

বাম নেভিগেশন মেনুর Libraries অপশন হলো যেখানে আপনি অন্য লোকেরা লিখে থাকা লাইব্রেরি অ্যাক্সেস করতে পারেন (অথবা আপনি লিখে অন্য কোথাও সেভ করে থাকেন)। এটি উপযোগী যদি আপনার কোনো বন্ধু থাকে যে Google Sheets বা Google Docs-এ ইতিমধ্যে একটি ফিচার লিখে থাকেন কিন্তু আপনি সেটির ওপর আরও কিছু ফিচার যোগ করতে চান।

সেসব লাইব্রেরি আপনার প্রজেক্টে যোগ করার জন্য আপনার প্রয়োজন Script ID। এটি প্রজেক্ট সেটিংস সেকশনে পাওয়া যায়, যা আমরা আর্টিকেলের শেষে খুঁজে বের করার উপায় দেখাব।

Google Apps Script Services Add-Ons

Services সেকশন সবচেয়ে উপযোগী। এটি হলো যেখানে আপনি আপনার করেন্ট স্ক্রিপ্টকে অন্যান্য Google সার্ভিসের সাথে ইন্টিগ্রেট করতে পারেন যা আপনি ব্যবহার করছেন।

আপনি যখন এটি সিলেক্ট করবেন, তবে Add a service উইন্ডো খুলবে। আপনি যে সার্ভিসটি আড-অন হিসেবে আপনার বিদ্যমান প্রজেক্টে ব্যবহার করতে চান সেটি পাওয়ার জন্য নিচে স্ক্রল করুন।

উদাহরণস্বরূপ, আপনি যদি আপনার Google Analytics অ্যাকাউন্ট থেকে ডেটা এই স্ক্রিপ্টে টানতে চান, তবে আপনি Google Analytics API সিলেক্ট করতে পারেন, এবং Add সিলেক্ট করতে পারেন।

আপনি যদি সেই নতুন আড-অন সার্ভিসের জন্য কী ফাংশন উপলব্ধ এবং কীভাবে ব্যবহার করতে হবে সেটি সম্পর্কে ডিটেল জানতে চান, তবে API-এর ডান পাশের তিন ডট সিলেক্ট করুন এবং See documentation সিলেক্ট করুন।

এটি একটি নতুন ট্যাবে Google Apps Script ডকুমেন্টেশন খুলবে, স্বয়ংক্রিয়ভাবে সেই Google সার্ভিসের সেকশনে খোলা।

ফাংশন সিনট্যাক্স, টিউটোরিয়াল, এবং কোড উদাহরণের জন্য ডকুমেন্টেশন এক্সপ্লোর করুন যা আপনি আপনার স্ক্রিপ্টে ব্যবহার করতে পারেন।

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

উদাহরণস্বরূপ, আপনি যদি Google Sheets-এ এডিটর খোলেন, তবে ডকুমেন্টেশন মেনুর Sheets সেকশন চেক করুন Google Sheets ফাংশন देखने জন্য যা আপনি আপনার স্ক্রিপ্টে ব্যবহার করতে পারেন।

Apps Script Triggers সেট আপ এবং ব্যবহার করা

Google Apps Script-এ আরেকটি উপযোগী ফিচার হলো ইভেন্ট বা শিডিউলের ওপর ভিত্তি করে ট্রিগার সেট করার ক্ষমতা।

আপনার স্ক্রিপ্টের জন্য একটি নতুন ট্রিগার কনফিগার করতে, ফার লেফট নেভিগেশন মেনুর Triggers সিলেক্ট করুন। খুলা নতুন Triggers উইন্ডোতে, Add Trigger বাটন সিলেক্ট করুন।

Add Trigger উইন্ডোর একটি দীর্ঘ অপশন লিস্ট আছে যা আপনাকে এক্সাক্টলি কাস্টমাইজ করতে সাহায্য করে কীভাবে এবং কখন আপনি আপনার স্ক্রিপ্ট চালাতে চান।

নোট: এই অপশনগুলো বেশিরভাগ আপনি যে সার্ভিসের জন্য স্ক্রিপ্ট লিখছেন বা আপনি যে API-গুলো অ্যাড করেছেন সেসের ওপর নির্ভর করে।

আপনার ট্রিগার সেট আপ করতে, আপনাকে বেছে নিতে হবে:

• কোন ফাংশনটি początমে লঞ্চ করবে
• ইভেন্ট সোর্স যেমন একটি নির্দিষ্ট সময়, তারিখ, অথবা আপনার সার্ভিসে একটি ইভেন্ট যেমন যখন একটি Google স্প্রেডশিট সেল পরিবর্তিত হয় বা একটি ডকুমেন্ট প্রথমবার খোলা হয়
• ইভেন্ট টাইপ যেমন যখন আপনার Google স্প্রেডশিট বা ডকুমেন্টে কিছু খোলা বা এডিট হয়, অথবা তারিখ বা সময়ের জন্য নির্দিষ্ট সেটিং
• নোটিফিকেশন ফ্রিকোয়েন্সি কতবার আপনি আপডেট পেতে চান আপনার স্ক্রিপ্ট ফেল হলে

আপনি একবার Save সিলেক্ট করলে, আপনি "Script authorization failed" মেসেজ দেখতে পারেন যদি এটি প্রথমবারের মতো আপনি একটি নতুন ট্রিগার সেভ করেছেন।

এটি সাধারণত ট্রিগার হয় আপনার ব্রাউজারে পপ-আপ ব্লকার ইন্যাবল্ড থাকলে। আপনি যদি Google Chrome ব্যবহার করেন, তবে ছোট উইন্ডো আইকন যেটিতে লাল "X" আছে সেটি সিলেক্ট করুন। সেটিং পরিবর্তন করুন Always allow pop-ups-এ এবং Done সিলেক্ট করুন।

আপনি আবার Save সিলেক্ট করলে, আপনাকে আপনার লেখা স্ক্রিপ্টকে আপনার Google অ্যাকাউন্ট বা Google Workspace-এ রান করার অনুমতি দেয়া প্রসেস থেকে গুজরতে হবে।

প্রথমে, আপনি যে Google অ্যাকাউন্টে আপনার স্ক্রিপ্ট চালাতে চান সেটি সিলেক্ট করুন।

আপনি একটি ওয়ার্নিং দেখবেন যে আপনার লেখা কাস্টম ফাংশন বা স্ক্রিপ্ট Google দ্বারা "verified" নয়। আপনি যদি স্ক্রিপ্টটি লিখেছেন, তবে এটি মaterra এবং আপনার নিজস্ব Google Account বা Google Workspace-এ রান করার জন্য সেফ।

এই ওয়ার্নিং বাইপাস করতে, শুধু Advanced সিলেক্ট করুন এবং তারপর নিচে Go to <project> (unsafe) লিংক সিলেক্ট করুন।

শেষে, পারমিশন উইন্ডোতে, Allow সিলেক্ট করুন আপনার কাস্টম ফাংশন এবং স্ক্রিপ্ট আপনার Google অ্যাকাউন্ট বা Google Workspace-এ রান করার অনুমতি দিতে।

আপনাকে এই প্রসেস আবার রিপিট করতে হবে না, শুধু প্রথমবার আপনার কাস্টম Google Apps Script প্রজেক্ট সেভ বা রান করার সময়।

আপনার Google Script ID এক্সেস করা

একটি চূড়ান্ত নোট—আপনি আপনার স্ক্রিপ্ট বন্ধু বা সহকর্মীদের সাথে শেয়ার করতে চান যাতে সারা আপনার স্ক্রিপ্ট ব্যবহার করতে পারে বা তাদের নিজস্ব স্ক্রিপ্টে লাইব্রেরি হিসেবে অ্যাড করতে পারে।

আপনি আপনার Script ID পাবেন ফার লেফট নেভিগেশন পেনের Settings আইকনে।

Script ID পাওয়া যায় IDs সেকশনের অধীনে, Script ID-এর ডান পাশে।

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