এই পৃষ্ঠায় Google Workspace অ্যাড-অনগুলি কীভাবে ডিজাইন, তৈরি এবং প্রকাশ করতে হয় তার একটি সারসংক্ষেপ দেওয়া হয়েছে। এই সারসংক্ষেপে নিম্নলিখিত পদক্ষেপগুলি ব্যাখ্যা করা হয়েছে:
- আপনার অ্যাড-অন ব্যবহারকারীদের জন্য কোন কোন Google Workspace অ্যাপ্লিকেশনগুলিতে উপলব্ধ করতে চান তা নির্ধারণ করুন।
- আপনার অ্যাড-অনের প্রকল্পগুলি সেট আপ করুন এবং একজন মালিক এবং সহযোগী নির্বাচন করুন।
- আপনার অ্যাড-অনের চেহারা এবং আচরণ ডিজাইন এবং কনফিগার করুন।
- অ্যাড-অন তৈরি করুন।
- আপনার অ্যাড-অনের OAuth স্কোপ যাচাই করুন।
- এক বা একাধিক Google Workspace অ্যাপ্লিকেশনের মধ্যে অ্যাড-অনটি পরীক্ষা করুন।
- অ্যাড-অনটি প্রকাশ করুন।
আপনি অ্যাপস স্ক্রিপ্ট অথবা HTTP দিয়ে একটি অ্যাড-অন তৈরি করতে পারেন। তুলনা করার জন্য, "অ্যাপস স্ক্রিপ্ট বনাম HTTP এন্ডপয়েন্ট: আপনার কোনটি বেছে নেওয়া উচিত? 🤔" ভিডিওটি দেখুন।
Google Workspace হোস্ট অ্যাপ্লিকেশন বেছে নিন
আপনি নিম্নলিখিত Google Workspace হোস্ট অ্যাপ্লিকেশনগুলিতে Google Workspace অ্যাড-অনগুলি প্রদর্শিত হওয়ার জন্য কনফিগার করতে পারেন:
- জিমেইল
- গুগল ক্যালেন্ডার
- গুগল চ্যাট
- গুগল ডক্স
- গুগল ড্রাইভ
- গুগল মিট
- গুগল শিটস
- গুগল স্লাইডস
Google Workspace অ্যাপ্লিকেশনের জন্য কীভাবে তৈরি করবেন তা জানতে, Google Workspace UI প্রসারিত করুন দেখুন।
আপনার অ্যাড-অনের প্রকল্পগুলি সেট আপ করুন এবং একজন মালিক এবং সহযোগী নির্বাচন করুন
আপনি যদি অ্যাপস স্ক্রিপ্টে আপনার অ্যাড-অন তৈরি করেন, তাহলে আপনি একটি অ্যাপস স্ক্রিপ্ট প্রজেক্ট এবং একটি গুগল ক্লাউড প্রজেক্ট উভয়ই তৈরি করবেন। আপনি যদি অ্যাপস স্ক্রিপ্ট ছাড়া অন্য কোনও ভাষায় আপনার অ্যাড-অন তৈরি করেন, তাহলে আপনাকে কেবল একটি গুগল ক্লাউড প্রজেক্ট তৈরি করতে হবে।
অ্যাড-অন ডেভেলপমেন্ট শুরু করার আগে, প্রকল্পগুলির মালিকানা পেতে একটি একক ব্যবহারকারী অ্যাকাউন্ট বেছে নিন এবং অন্য কোন অ্যাকাউন্টগুলি সহযোগী তা নির্ধারণ করুন। প্রকল্পের মালিক প্রকল্প ফাইল এবং সংশ্লিষ্ট সেটিংস তৈরি এবং পরিচালনা করেন, অন্যদিকে সহযোগীরা কোডিং এবং পরীক্ষায় সহায়তা করতে পারেন।
অ্যাপস স্ক্রিপ্ট প্রকল্প
আপনার অ্যাড-অন তৈরি করার আগে, আপনার প্রকল্পের নকশা এই নির্দেশিকাগুলির সাথে সামঞ্জস্যপূর্ণ কিনা তা নিশ্চিত করার জন্য অ্যাপস স্ক্রিপ্ট কোটা এবং সীমাবদ্ধতাগুলি পর্যালোচনা করুন। ছোট ব্যবহারকারী বেস সহ ব্যক্তিগত বা অভ্যন্তরীণ অ্যাড-অনগুলির হালকা বিকাশের জন্য অ্যাপস স্ক্রিপ্ট সেরা। যদি আপনি এমন একটি বৃহৎ-স্কেল অ্যাড-অন তৈরি করার পরিকল্পনা করেন যার জন্য অনেক ব্যবহারকারী পরিচালনা করতে হবে, কম লেটেন্সি প্রয়োজন হবে, অথবা আপনার পরিকাঠামোর উপর সম্পূর্ণ নিয়ন্ত্রণ প্রয়োজন, তাহলে একটি ভিন্ন রানটাইম পরিবেশে বিকাশের কথা বিবেচনা করুন।
আপনি আপনার অ্যাড-অনের অ্যাপস স্ক্রিপ্ট প্রজেক্ট ফাইলগুলি একটি শেয়ার্ড ড্রাইভে তৈরি করতে পারেন যাতে কোনও একক অ্যাকাউন্টের একক মালিকানা না থাকে। আপনার অ্যাড-অন স্ক্রিপ্ট ফাইলটি একটি শেয়ার্ড ড্রাইভে রাখলে নিশ্চিত হয় যে একাধিক সহযোগীর স্ক্রিপ্ট প্রজেক্টে অ্যাক্সেস রয়েছে।
যখন আপনি একটি অ্যাড-অন প্রকাশ করেন, তখন একটি একক ব্যবহারকারী অ্যাকাউন্ট প্রকাশক হিসেবে কাজ করে। প্রকাশনা অ্যাকাউন্টের স্ক্রিপ্ট প্রকল্পে সম্পাদনা অ্যাক্সেস থাকতে হবে, তবে এটির মালিক হওয়ার প্রয়োজন নেই।
একটি অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করতে, স্ক্রিপ্ট প্রকল্প দেখুন।
গুগল ক্লাউড প্রকল্প
আমরা আপনাকে অ্যাড-অনের ক্লাউড প্রজেক্টে সহযোগীদের যোগ করার পরামর্শ দিচ্ছি। এটি নিশ্চিত করতে সাহায্য করে যে আপনার টিমের কেউ সর্বদা অ্যাড-অনের ক্লাউড সেটিংস অ্যাক্সেস করতে পারে।
একটি গুগল ক্লাউড প্রকল্প তৈরি করতে, একটি গুগল ক্লাউড প্রকল্প তৈরি করুন দেখুন।
আপনার অ্যাড-অনের চেহারা এবং আচরণ ডিজাইন এবং কনফিগার করুন
আপনার অ্যাড-অনটি কেমন দেখতে চান এবং এটি কীভাবে আচরণ করবে তা তৈরি করার আগে ঠিক করুন। অ্যাড-অনটি কোন ব্যবহারের ক্ষেত্রে সমাধান প্রদানের চেষ্টা করবে তা বিবেচনা করুন। প্রথমে কাজ শুরু করার জন্য একটি সাধারণ নকশা দিয়ে শুরু করুন, তারপরে আরও পরিমার্জন যোগ করুন।
আপনার অ্যাড-অন ব্যবহারকারীর অভিজ্ঞতা কীভাবে ডিজাইন করবেন তার নির্দেশিকাগুলির জন্য Google Workspace অ্যাড-অন স্টাইল গাইডটি দেখুন।
অ্যাড-অন ম্যানিফেস্ট কনফিগার করুন
আপনার অ্যাড-অন ডিজাইন করার পর, আপনি অ্যাড-অন ম্যানিফেস্টে ডিজাইনটি বাস্তবায়ন শুরু করতে পারেন। ম্যানিফেস্ট হল সেই জায়গা যেখানে আপনি অ্যাড-অনের বেশিরভাগ চেহারা এবং আচরণ কনফিগার করেন, যার মধ্যে অ্যাড-অনটি যে Google Workspace হোস্ট অ্যাপ্লিকেশনগুলি প্রসারিত করে তাও অন্তর্ভুক্ত।
বিস্তারিত জানার জন্য, Google Workspace অ্যাড-অনের জন্য ম্যানিফেস্ট দেখুন।
আপনার অ্যাড-অনে কোড এবং বৈশিষ্ট্য যোগ করার সাথে সাথে, প্রয়োজনীয় অ্যাড-অন চেহারা এবং আচরণ তৈরি করতে প্রয়োজন অনুসারে ম্যানিফেস্ট সম্পাদনা করুন।
Google Chat অ্যাপের উপস্থিতি এবং আচরণ কনফিগার করুন
যদি আপনি এমন একটি অ্যাড-অন ডিজাইন করে থাকেন যা Google Chat প্রসারিত করে, তাহলে আপনাকে Chat অ্যাপের চেহারা এবং আচরণ কনফিগার করতে Google Chat API ব্যবহার করতে হবে। ধাপগুলির জন্য, একটি Google Chat অ্যাপ কনফিগার করুন দেখুন।
অ্যাড-অন তৈরি করুন
অ্যাড-অনের জন্য আপনাকে অবশ্যই একটি কার্ড-ভিত্তিক ইন্টারফেস প্রয়োগ করতে হবে। অ্যাপস স্ক্রিপ্টের কার্ড পরিষেবা ব্যবহার করুন অথবা যদি আপনি অন্য কোড ভাষায় লেখেন, তাহলে ইন্টারফেসটিকে কার্ড হিসাবে রেন্ডার করার জন্য সঠিকভাবে ফর্ম্যাট করা JSON ফেরত দিন।
আপনাকে অ্যাড-অন ম্যানিফেস্টে উল্লেখিত যেকোনো ট্রিগার ফাংশন বাস্তবায়ন করতে হবে। যদি আপনার অ্যাড-অন OAuth ব্যবহার করে কোনও তৃতীয় পক্ষের, অ-গুগল পরিষেবার সাথে সংযুক্ত হয়, তাহলে আপনাকে সেই পরিষেবার জন্যও OAuth কনফিগার করতে হবে।
কার্ড তৈরি করুন
আপনি Card অবজেক্ট তৈরি করে এবং উইজেট দিয়ে পূরণ করে একটি অ্যাড-অন ইউজার ইন্টারফেস সংজ্ঞায়িত করতে পারেন। আপনার ম্যানিফেস্টে নির্দিষ্ট ট্রিগার ফাংশনগুলিকে অবশ্যই একটি একক Card অবজেক্ট অথবা অ্যাড-অন ইন্টারফেসের বিভিন্ন 'পৃষ্ঠা' প্রতিনিধিত্বকারী Card অবজেক্টের একটি অ্যারে ফেরত পাঠাতে হবে। আপনার অ্যাড-অন ব্যবহারকারীর ক্রিয়াকলাপের প্রতিক্রিয়ায় নতুন কার্ড তৈরি এবং প্রদর্শন করতে পারে।
অ্যাপস স্ক্রিপ্টে, আপনি CardBuilder ক্লাস ব্যবহার করে কার্ড তৈরি করেন। প্রতিটি কার্ডের জন্য একটি CardHeader এবং এক বা একাধিক CardSections প্রয়োজন। আপনার প্রতিটি কার্ড বিভাগে অ্যাড-অন ইন্টারফেস তৈরি করে এমন পৃথক উইজেটগুলি পূরণ করা উচিত। ইন্টারঅ্যাকশন উইজেটগুলি সাধারণত তাদের ইন্টারঅ্যাকশন আচরণ সংজ্ঞায়িত করার জন্য অ্যাকশনের সাথে লিঙ্ক করা হয়।
আপনার কার্ডের CardBuilder এর মাধ্যমে সমস্ত বিভাগ এবং উইজেট যোগ করার পরে, সংশ্লিষ্ট Card অবজেক্ট তৈরি করতে আপনাকে CardBuilder.build() কল করতে হবে।
আপনার তৈরি অ্যাড-অন কার্ডগুলিতে প্রদর্শিত তথ্য পুনরুদ্ধার করতে আপনি অন্যান্য বিল্ট-ইন অ্যাপস স্ক্রিপ্ট পরিষেবা যেমন CalendarApp ব্যবহার করতে পারেন। আপনি নন-গুগল পরিষেবা থেকে আনা ডেটা ব্যবহার করতে পারেন।
যদি আপনার অ্যাড-অনের OAuth প্রয়োজন এমন নন-গুগল API গুলিতে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনাকে অবশ্যই সেই পরিষেবাটি কনফিগার করে তার সাথে সংযোগ স্থাপন করতে হবে—আরও বিস্তারিত জানার জন্য নন-গুগল পরিষেবাগুলিতে সংযোগ স্থাপন নির্দেশিকা দেখুন।
নির্মাণ আদেশ
কার্ড তৈরি করার সময়, আপনাকে অবশ্যই উপরে থেকে তৈরি করতে হবে। অর্থাৎ, আপনাকে এই নির্মাণ ক্রমটি ব্যবহার করতে হবে:
- উইজেট তৈরি করুন।
- কার্ড বিভাগে উইজেট যোগ করুন।
- কার্ড বিভাগে সমস্ত উইজেট না আসা পর্যন্ত পুনরাবৃত্তি করুন।
- কার্ডের সাথে কার্ড বিভাগটি যোগ করুন।
এটি প্রয়োজন কারণ যখন আপনি একটি কার্ড বা কার্ড বিভাগে একটি উইজেট যোগ করেন, তখন আপনি আসলে সেই উইজেটের একটি কপি যোগ করছেন। উইজেট অবজেক্ট যোগ করার পরে আপনি যে কোনও পরিবর্তন করেন তা চূড়ান্ত কার্ডে প্রতিফলিত হয় না।
সর্বজনীন কর্ম
আপনি প্রসঙ্গ-স্বাধীন কার্যকারিতা প্রদানের জন্য সর্বজনীন ক্রিয়া ব্যবহার করতে পারেন। সর্বজনীন ক্রিয়া হল মেনু আইটেম যা অ্যাড-অন UI-তে উপলব্ধ, তা কোন কার্ড প্রদর্শিত হচ্ছে তা নির্বিশেষে। সমস্ত সংজ্ঞায়িত সর্বজনীন ক্রিয়া সর্বদা অ্যাড-অনের কার্ড মেনুতে উপস্থিত হয়।
আরও বিস্তারিত জানার জন্য সর্বজনীন কর্মকাণ্ড দেখুন।
অ্যাড-অন OAuth স্কোপগুলি যাচাই করুন
স্কোপগুলি ব্যবহারকারীর পক্ষ থেকে অ্যাড-অন কী কী পদক্ষেপ নিতে পারবে তা নির্ধারণ করে। অ্যাড-অনগুলির জন্য এটি সর্বোত্তম অনুশীলন যে কেবল সেই পদক্ষেপগুলির জন্য স্কোপ থাকা উচিত যা তাদের কাজ করার জন্য আবশ্যক, আর কিছু নয়।
অ্যাড-অন প্রকল্পগুলিতে, অ্যাড-অন স্কোপগুলিকে স্পষ্টভাবে সেট করুন যাতে অ্যাড-অনটি সম্ভাব্য সর্বনিম্ন-অনুমোদনযোগ্য স্কোপ সেট ব্যবহার করে। অ্যাড-অন ম্যানিফেস্টে আপনার অ্যাড-অন কোন স্কোপ ব্যবহার করে তা আপনি নির্ধারণ করতে পারেন।
আরও বিস্তারিত জানার জন্য স্কোপস দেখুন।
অ্যাড-অনটি পরীক্ষা করুন
আপনি প্রথমে অপ্রকাশিত অ্যাড-অন ইনস্টল করে অপ্রকাশিত অ্যাড-অন পরীক্ষা করতে পারেন। ইনস্টল এবং অনুমোদিত হয়ে গেলে, আপনি আপনার অ্যাকাউন্টে অ্যাড-অনটি ব্যবহার করতে পারেন এবং এটি যে হোস্ট অ্যাপ্লিকেশনগুলি প্রসারিত করে তাতে এর উপস্থিতি এবং আচরণ পরীক্ষা করতে পারেন। আপনার যাচাই করা উচিত যে অ্যাড-অনটি প্রসঙ্গ এবং ব্যবহারকারীর ক্রিয়াকলাপের জন্য প্রত্যাশা অনুযায়ী আচরণ করে।
আপনার অ্যাড-অন পরীক্ষা শুরু করতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:
- অ্যাপস স্ক্রিপ্ট গুগল ওয়ার্কস্পেস অ্যাড-অন পরীক্ষা এবং ডিবাগ করুন
- HTTP Google Workspace অ্যাড-অন পরীক্ষা এবং ডিবাগ করুন
- Google Chat অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্য পরীক্ষা করুন
অ্যাড-অনটি প্রকাশ করুন
আপনার অ্যাড-অন প্রকাশ করলে এটি অন্যদের জন্য উপলব্ধ হবে, হয় সর্বজনীনভাবে অথবা শুধুমাত্র আপনার ডোমেনের ব্যবহারকারীদের জন্য। প্রকাশনা প্রক্রিয়া শুরু করার আগে, প্রকাশনার সারসংক্ষেপটি পর্যালোচনা করতে ভুলবেন না। প্রকাশনা একটি জটিল প্রক্রিয়া যার প্রস্তুতি এবং সম্পূর্ণ করার জন্য সময় প্রয়োজন।
Google Workspace অ্যাড-অনগুলি Google Workspace Marketplace- এ প্রকাশিত হয়। সর্বজনীনভাবে উপলব্ধ অ্যাড-অনগুলি প্রকাশিত হওয়ার আগে অ্যাপ পর্যালোচনা সম্পূর্ণ করতে হবে।
আরও বিস্তারিত জানার জন্য প্রকাশনা Google Workspace অ্যাড-অন দেখুন।