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