Google Workspace অ্যাড-অন তৈরি করুন

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

  1. গুগল ওয়ার্কস্পেসের সেই অ্যাপ্লিকেশনগুলো নির্ধারণ করুন যেখানে আপনি আপনার অ্যাড-অনটি ব্যবহারকারীদের জন্য উপলব্ধ করতে চান।
  2. আপনার অ্যাড-অনগুলোর প্রজেক্ট সেট আপ করুন এবং একজন মালিক ও সহযোগী নির্বাচন করুন।
  3. আপনার অ্যাড-অনের চেহারা ও আচরণ ডিজাইন এবং কনফিগার করুন।
  4. অ্যাড-অনটি তৈরি করুন।
  5. আপনার অ্যাড-অনের OAuth স্কোপগুলো যাচাই করুন।
  6. এক বা একাধিক গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনের মধ্যে অ্যাড-অনটি পরীক্ষা করুন।
  7. অ্যাড-অনটি প্রকাশ করুন।

আপনি অ্যাপস স্ক্রিপ্ট বা এইচটিটিপি দিয়ে একটি অ্যাড-অন তৈরি করতে পারেন। তুলনার জন্য, "অ্যাপস স্ক্রিপ্ট বনাম এইচটিটিপি এন্ডপয়েন্ট: কোনটি বেছে নেবেন? 🤔" ভিডিওটি দেখুন।

গুগল ওয়ার্কস্পেস হোস্ট অ্যাপ্লিকেশন নির্বাচন করুন

আপনি নিম্নলিখিত Google Workspace হোস্ট অ্যাপ্লিকেশনগুলিতে Google Workspace অ্যাড-অনগুলি প্রদর্শিত হওয়ার জন্য কনফিগার করতে পারেন:

  • জিমেইল
  • গুগল ক্যালেন্ডার
  • গুগল চ্যাট
  • গুগল ডক্স
  • গুগল ড্রাইভ
  • গুগল মিট
  • গুগল শীটস
  • গুগল স্লাইডস

গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনের জন্য কীভাবে বিল্ড করতে হয় সে সম্পর্কে জানতে, ‘এক্সটেন্ড দ্য গুগল ওয়ার্কস্পেস ইউআই’ দেখুন।

আপনার অ্যাড-অনের প্রজেক্টগুলো সেট আপ করুন এবং একজন মালিক ও সহযোগী নির্বাচন করুন।

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

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

অ্যাপস স্ক্রিপ্ট প্রকল্প

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

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

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

একটি অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি করতে, স্ক্রিপ্ট প্রজেক্টস দেখুন।

গুগল ক্লাউড প্রকল্প

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

একটি গুগল ক্লাউড প্রজেক্ট তৈরি করতে, "একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন" দেখুন।

আপনার অ্যাড-অনের চেহারা ও আচরণ ডিজাইন এবং কনফিগার করুন।

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

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

অ্যাড-অন ম্যানিফেস্ট কনফিগার করুন

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

বিস্তারিত জানতে, Google Workspace অ্যাড-অন-এর ম্যানিফেস্টসমূহ দেখুন।

আপনার অ্যাড-অনে কোড এবং ফিচার যোগ করার সাথে সাথে, প্রয়োজনীয় অ্যাড-অনের চেহারা ও আচরণ তৈরি করার জন্য প্রয়োজন অনুযায়ী ম্যানিফেস্টটি সম্পাদনা করুন।

গুগল চ্যাট অ্যাপের চেহারা ও আচরণ কনফিগার করুন

আপনি যদি গুগল চ্যাট-এর কার্যকারিতা বর্ধনকারী কোনো অ্যাড-অন ডিজাইন করে থাকেন, তাহলে একটি চ্যাট অ্যাপের চেহারা ও আচরণ কনফিগার করার জন্য আপনাকে অবশ্যই গুগল চ্যাট এপিআই (API) ব্যবহার করতে হবে। এর ধাপগুলোর জন্য, ‘একটি গুগল চ্যাট অ্যাপ কনফিগার করুন’ দেখুন।

অ্যাড-অনটি তৈরি করুন

আপনাকে অ্যাড-অনটির জন্য একটি কার্ড-ভিত্তিক ইন্টারফেস ইমপ্লিমেন্ট করতে হবে। অ্যাপস স্ক্রিপ্টের কার্ড সার্ভিসটি ব্যবহার করুন, অথবা যদি আপনি অন্য কোনো কোড ল্যাঙ্গুয়েজে লেখেন, তাহলে ইন্টারফেসটিকে কার্ড হিসেবে রেন্ডার করার জন্য যথাযথভাবে ফরম্যাট করা JSON রিটার্ন করুন।

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

কার্ড তৈরি করুন

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

অ্যাপস স্ক্রিপ্টে, আপনি CardBuilder ক্লাস ব্যবহার করে কার্ড তৈরি করেন। প্রতিটি কার্ডের জন্য একটি CardHeader এবং এক বা একাধিক CardSections প্রয়োজন। অ্যাড-অন ইন্টারফেস গঠনকারী স্বতন্ত্র উইজেটগুলো দিয়ে প্রতিটি কার্ড সেকশন পূরণ করা উচিত। ইন্টারঅ্যাকশন উইজেটগুলোর ইন্টারঅ্যাকশন আচরণ নির্ধারণ করার জন্য সেগুলোকে সাধারণত অ্যাকশনের সাথে লিঙ্ক করা হয়।

আপনার কার্ডের CardBuilder এর মাধ্যমে সমস্ত সেকশন এবং উইজেট যোগ করার পরে, সংশ্লিষ্ট Card অবজেক্টটি তৈরি করার জন্য আপনাকে অবশ্যই CardBuilder.build() কল করতে হবে।

আপনার তৈরি করা অ্যাড-অন কার্ডগুলিতে দেখানোর জন্য তথ্য সংগ্রহ করতে আপনি CalendarApp মতো অন্যান্য বিল্ট-ইন অ্যাপস স্ক্রিপ্ট পরিষেবা ব্যবহার করতে পারেন। আপনি গুগল-বহির্ভূত পরিষেবা থেকে সংগৃহীত ডেটাও ব্যবহার করতে পারেন।

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

নির্মাণ আদেশ

কার্ড তৈরি করার সময়, আপনাকে উপর থেকে উপরের দিকে তৈরি করতে হবে। অর্থাৎ, আপনাকে এই নির্মাণ ক্রমটি ব্যবহার করতে হবে:

  1. উইজেটটি তৈরি করুন।
  2. উইজেটটি কার্ড সেকশনে যোগ করুন।
  3. কার্ড সেকশনে সব উইজেট যুক্ত না হওয়া পর্যন্ত পুনরাবৃত্তি করুন।
  4. কার্ডে কার্ড সেকশনটি যোগ করুন।

এর প্রয়োজন হয়, কারণ যখন আপনি কোনো কার্ড বা কার্ড সেকশনে একটি উইজেট যোগ করেন, তখন আপনি আসলে সেই উইজেটটির একটি অনুলিপি যোগ করেন। উইজেটটি যোগ করার পরে আপনি উইজেট অবজেক্টে যে কোনো পরিবর্তন করলে তা চূড়ান্ত কার্ডে প্রতিফলিত হয় না।

সর্বজনীন ক্রিয়া

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

আরও বিস্তারিত জানতে ইউনিভার্সাল অ্যাকশনস দেখুন।

অ্যাড-অন OAuth স্কোপগুলি যাচাই করুন

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

অ্যাড-অন প্রজেক্টে, অ্যাড-অন স্কোপগুলো স্পষ্টভাবে সেট করুন, যাতে অ্যাড-অনটি সম্ভাব্য সর্বনিম্ন অনুমতিসম্পন্ন স্কোপ সেট ব্যবহার করে। আপনার অ্যাড-অন কোন স্কোপগুলো ব্যবহার করবে, তা আপনি অ্যাড-অন ম্যানিফেস্টে নির্ধারণ করেন।

আরও বিস্তারিত জানতে পরিধি দেখুন।

অ্যাড-অনটি পরীক্ষা করুন

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

আপনার অ্যাড-অন পরীক্ষা করা শুরু করতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

অ্যাড-অনটি প্রকাশ করুন

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলি গুগল ওয়ার্কস্পেস মার্কেটপ্লেসে প্রকাশ করা হয়। সর্বজনীনভাবে উপলব্ধ অ্যাড-অনগুলিকে প্রকাশের আগে অবশ্যই অ্যাপ পর্যালোচনা সম্পন্ন করতে হয়।

আরও বিস্তারিত জানতে ‘পাবলিশিং গুগল ওয়ার্কস্পেস’ অ্যাড-অনটি দেখুন।