Google Apps স্ক্রিপ্টের সাথে হ্যান্ডস-অন: কোডের 4 লাইনে Google পত্রক, মানচিত্র এবং Gmail অ্যাক্সেস করা!

১. গুগল অ্যাপস স্ক্রিপ্ট পরিচিতি

এই কোডল্যাবে, আমরা আপনাকে গুগল ডেভেলপার টেকনোলজি ব্যবহার করে কোড লেখার অন্যতম সহজ একটি পদ্ধতির সাথে পরিচয় করিয়ে দেব। এটি করা হয় জাভাস্ক্রিপ্ট প্রয়োগের মাধ্যমে, যা একটি বহুল প্রচলিত ওয়েব ডেভেলপমেন্ট ল্যাঙ্গুয়েজ। গুগল অ্যাপস স্ক্রিপ্ট ব্যবহার করে, আপনি একটি গুগল শিটের সেল থেকে রাস্তার ঠিকানা বের করার, সেই ঠিকানার উপর ভিত্তি করে একটি গুগল ম্যাপ তৈরি করার এবং তারপর জিমেইল ব্যবহার করে ম্যাপটি অ্যাটাচমেন্ট হিসেবে পাঠানোর জন্য কোড লিখবেন। সবচেয়ে ভালো দিকটি হলো? এর জন্য মাত্র চার লাইনের কোড লাগবে।

আপনি যা শিখবেন

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

আপনার যা যা লাগবে

  • ইন্টারনেট সংযোগসহ একটি ওয়েব ব্রাউজার
  • একটি গুগল অ্যাকাউন্ট (গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য প্রশাসকের অনুমোদনের প্রয়োজন হতে পারে)
  • গুগল শিটস সম্পর্কে প্রাথমিক ধারণা
  • শীট A1 নোটেশন পড়ার ক্ষমতা

২. জরিপ

আপনি এই কোডল্যাব/টিউটোরিয়ালটি কীভাবে ব্যবহার করবেন?

শুধু পুরোটা পড়ুন এটি পড়ুন এবং অনুশীলনগুলো সম্পূর্ণ করুন।

গুগল ওয়ার্কস্পেস ডেভেলপার টুলস ও এপিআই ব্যবহারের অভিজ্ঞতাকে আপনি কীভাবে মূল্যায়ন করবেন?

শিক্ষানবিশ মধ্যবর্তী দক্ষ

৩. সংক্ষিপ্ত বিবরণ

এখন যেহেতু আপনি জানেন এই কোডল্যাবটি কী নিয়ে, আপনি ঠিক কী করতে যাচ্ছেন?

  1. অ্যাপস স্ক্রিপ্ট সম্পর্কে কিছুটা জেনে নিন, যা জাভাস্ক্রিপ্টের উপর ভিত্তি করে তৈরি।
  2. একটি গুগল শিটস স্প্রেডশিট তৈরি করুন।
  3. স্প্রেডশীটের উপরের বাম দিকের সেলে (A1) একটি রাস্তার ঠিকানা লিখুন।
  4. যেকোনো ডকুমেন্টের জন্য অ্যাপস স্ক্রিপ্ট এডিটর কীভাবে খুলতে হয় তা শিখুন।
  5. অ্যাপস স্ক্রিপ্ট কোডটি সম্পাদনা করুন, সংরক্ষণ করুন এবং চালান।
  6. ফলাফল দেখতে জিমেইল ব্যবহার করুন।

চলুন শুরু করা যাক।

গুগল অ্যাপস স্ক্রিপ্ট কী?

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

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

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

৪. একটি গুগল শিট তৈরি করুন এবং রাস্তার ঠিকানা লিখুন।

একটি নতুন গুগল শিটে, এই নির্দেশাবলী অনুসরণ করে একটি বৈধ রাস্তার ঠিকানা লিখুন:

  1. এই সুবিধাজনক লিঙ্কটি ( sheets.google.com/create ) ব্যবহার করে একটি গুগল শিট তৈরি করুন। বিকল্পভাবে, আপনার গুগল ড্রাইভে ( drive.google.com ) যান এবং New > Google Sheets > Blank spreadsheet -এ ক্লিক করুন।

413a93e5b2f6b3d4.png

  1. খালি স্প্রেডশীটটির উপরের বাম কোণার প্রথম সেলটিতে (A1) যান। এটি A কলাম এবং ১ নম্বর সারিতে থাকবে। যদি আপনার বিষয়টি পুনরায় মনে করার প্রয়োজন হয়, তাহলে আপনি A1 নোটেশনের এই বিবরণটি দেখে নিতে পারেন।
  2. নির্দিষ্ট ঘরে একটি বৈধ রাস্তার ঠিকানা লিখুন। রাস্তার ঠিকানা, জিপ/পোস্টাল কোড, অথবা শহর এবং রাজ্য/প্রদেশের সমন্বয় ব্যবহার করে বিশ্বের যেকোনো একটি সঠিক অবস্থানের ঠিকানা বেছে নিন। এখানে নিউ ইয়র্ক সিটির একটি ঠিকানার উদাহরণ দেওয়া হলো:

7077e446455639df.png

শীটটিতে আপনাকে শুধু এটুকুই করতে হবে। চলুন এডিটরটি খুলে কিছু কোড লিখি।

৫. অ্যাপস স্ক্রিপ্ট কোড সম্পাদনা করুন

এখন যেহেতু আপনার একটি নতুন গুগল শিট আছে, এর বাউন্ড স্ক্রিপ্টটি সম্পাদনা করার সময় এসেছে। এই নির্দেশাবলী অনুসরণ করুন:

স্ক্রিপ্ট এডিটর খুলুন

মেনু বারে, এক্সটেনশন > অ্যাপস স্ক্রিপ্ট নির্বাচন করলে অ্যাপস স্ক্রিপ্টের জন্য ব্রাউজার কোড এডিটরটি খুলবে।

একটি নতুন ব্রাউজার ট্যাবে, কোড এডিটরটি শীটটির জন্য ডিফল্ট কন্টেইনার-বাউন্ড স্ক্রিপ্টটি দেখায়। myFunction() নামের একটি ডিফল্ট ফাংশন স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায় এবং আপনার কার্সরটি ফাংশনটির ভিতরে চলে আসে, যাতে আপনি কাজ শুরু করতে পারেন।

ঠিকানাটির একটি গুগল ম্যাপ ইমেল করুন।

আপনাকে যে 'টেমপ্লেট' কোডটি দেওয়া হয়েছে তা খালি, তাই চলুন এটিকে আমাদের অ্যাপ্লিকেশন দিয়ে প্রতিস্থাপন করি।

  1. স্ক্রিপ্ট এডিটরে, ডিফল্ট myFunction() কোড ব্লকটি নিম্নলিখিত কোড দিয়ে প্রতিস্থাপন করুন: 
/** @OnlyCurrentDoc */
function sendMap() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var address = sheet.getRange('A1').getValue();
  var map = Maps.newStaticMap().addMarker(address);
  GmailApp.sendEmail('YOUR_EMAIL_ADDR', 'Map', 'See below.', {attachments:[map]});
}
  1. প্লেসহোল্ডার ইমেল ঠিকানাটি ( 'YOUR_EMAIL_ADDR' ) একটি বৈধ ঠিকানা দিয়ে প্রতিস্থাপন করুন। উদাহরণস্বরূপ, friend@example.com ।
  2. আপনার স্ক্রিপ্ট সংরক্ষণ করতে, সেভ-এ ক্লিক করুন। সংরক্ষণ করুন .
  3. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টের নাম পরিবর্তন করতে, ‘Untitled project’-এ ক্লিক করুন, আপনার প্রজেক্টের জন্য একটি শিরোনাম লিখুন এবং ‘Rename’-এ ক্লিক করুন।

কোড পর্যালোচনা

চলুন sendMap() ফাংশনের সেই ৪টি লাইন পর্যালোচনা করা যাক যা দিয়ে পুরো অ্যাপ্লিকেশনটি তৈরি। মজার ব্যাপার হলো, এই কোডে গুগলের ৩টি ভিন্ন প্রোডাক্টের রেফারেন্স রয়েছে।

প্রথম লাইনটি একটি টীকা মন্তব্য যা অনুমোদনকে প্রভাবিত করে:

/** @OnlyCurrentDoc */

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

কোডটিতে sendMap() এর জন্য একটি সাধারণ জাভাস্ক্রিপ্ট ফাংশন ডিক্লারেশন ব্যবহার করা হয়েছে:

function sendMap() {

পরবর্তী লাইনটি স্প্রেডশিট সার্ভিসকে কল করে, যা অ্যাপস স্ক্রিপ্ট থেকে SpreadsheetApp অবজেক্টের মাধ্যমে অ্যাক্সেসযোগ্য। ফেরত আসা শীটটি একই নামের একটি ভেরিয়েবলে অ্যাসাইন করা হয়। getActiveSheet() মেথডটি বর্তমান শীট অবজেক্টের একটি রেফারেন্স নেয় এবং সেটি sheet ) ভেরিয়েবলে সংরক্ষণ করে।

  var sheet = SpreadsheetApp.getActiveSheet();

sheet অবজেক্টে, আমরা getRange() ব্যবহার করে A1 নোটেশনে একটিমাত্র সেলের সেল রেঞ্জকে রেফারেন্স করি। একটি "রেঞ্জ" হলো কয়েকটি সেলের একটি সমষ্টি, যার মধ্যে A1 সেলের মতো একটিমাত্র সেলও অন্তর্ভুক্ত থাকে (যেটিতে আমরা অ্যাড্রেস দিয়েছিলাম)। রেঞ্জের ভেতরের ডেটা পেতে, getValue() মেথডটি রেঞ্জের উপরের-বামের সেলের মান রিটার্ন করে এবং সেই মানটি address ভেরিয়েবলে অ্যাসাইন করে। আপনি আরও অ্যাড্রেস যোগ করে বিভিন্ন সেল থেকে ডেটা পড়ার চেষ্টাও করতে পারেন।

  var address = sheet.getRange('A1').getValue();

কোডের তৃতীয় লাইনটি Maps অবজেক্ট ব্যবহার করে গুগল ম্যাপস সার্ভিসের সাথে সংযোগ স্থাপন করে। newStaticMap() একটি স্ট্যাটিক ম্যাপ অবজেক্ট তৈরি করে এবং addMarker() মেথডটি শীটে থাকা ঠিকানা ব্যবহার করে ম্যাপে একটি 'পিন' যোগ করে।

  var map = Maps.newStaticMap().addMarker(address);

সবশেষে, Gmail সার্ভিসটি MailApp অবজেক্টের মাধ্যমে sendEmail() মেথডকে কল করে ইমেলটি পাঠায়, যেটিতে "See below." লেখাটি এবং মানচিত্রের ছবিটি অ্যাটাচমেন্ট হিসেবে অন্তর্ভুক্ত থাকে।

  GmailApp.sendEmail('friend@example.com', 'Map', 'See below.', {attachments:[map]});
}

৬. গুগল শিটস, ম্যাপস এবং জিমেইল অ্যাপ চালু করুন।

একবার নামকরণ করে সংরক্ষণ করা হয়ে গেলে, এবার ফাংশনটি চালানোর পালা। এডিটরের উপরে, ফাংশন তালিকা থেকে sendMap() নির্বাচিত আছে কিনা তা নিশ্চিত করুন এবং রান (Run ) বোতামে ক্লিক করুন।

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

ba6e1a798e404e0d.png

চালিয়ে যেতে অনুমতি পর্যালোচনা করুন- এ ক্লিক করুন।

এরপর আপনার শীট অ্যাক্সেস করার এবং আপনার পক্ষ থেকে ইমেল পাঠানোর অনুমতি চেয়ে একটি OAuth2 ডায়ালগ উইন্ডো আসবে:

9bed7ef1ccbd7569.png

আপনি অনুমতি দেওয়ার পর স্ক্রিপ্টটি সম্পূর্ণভাবে চলে।

আপনি যে ইমেল অ্যাকাউন্ট থেকে বার্তাটি পাঠিয়েছেন সেটি পরীক্ষা করুন, সেখানে আপনি "Map" বিষয়সহ একটি ইমেল এবং এইরকম দেখতে একটি বার্তা খুঁজে পাবেন:

51f61fc51a13d28f.png

ইমেল বার্তার অ্যাটাচমেন্টটি খুললে, আপনি একটি গুগল ম্যাপ দেখতে পাবেন, যেখানে আপনার শীটে দেওয়া ঠিকানায় একটি পিন থাকবে।

739bb45b75e3f7c7.png

মাত্র চার লাইন কোডের মাধ্যমে আপনি অর্থপূর্ণভাবে গুগলের ৩টি ভিন্ন প্রোডাক্ট অ্যাক্সেস করেছেন।

৭. অতিরিক্ত সম্পদ

এই কোডল্যাবে ব্যবহৃত কোডটি এর গিটহাব রিপো github.com/googleworkspace/apps-script-intro-codelab- এও পাওয়া যায়। এই কোডল্যাবে আলোচিত বিষয়বস্তু আরও গভীরভাবে জানতে এবং প্রোগ্রাম্যাটিকভাবে গুগল ডেভেলপার টুলস ব্যবহারের অন্যান্য উপায় অন্বেষণ করতে নিচে আরও কিছু রিসোর্স দেওয়া হলো।

ডকুমেন্টেশন

ভিডিও

সংবাদ ও আপডেট

অন্যান্য কোডল্যাব

ভূমিকা

মধ্যবর্তী

রেফারেন্স অ্যাপ্লিকেশন