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

আপনি যখন একটি নতুন Google Workspace অ্যাড-অন তৈরি করতে চান, এই সাধারণ পদ্ধতি অনুসরণ করুন:

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

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

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

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

Apps স্ক্রিপ্ট প্রকল্প

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

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

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

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

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

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

আপনার অ্যাড-অন ব্যবহারকারীর অভিজ্ঞতা কীভাবে ডিজাইন করবেন তার নির্দেশিকাগুলির জন্য 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 পরিষেবাগুলির সাথে সংযোগ করার নির্দেশিকা দেখুন৷

নির্মাণ আদেশ

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

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

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

সর্বজনীন কর্ম

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

আরো বিস্তারিত জানার জন্য সার্বজনীন কর্ম দেখুন.

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

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

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

আরো বিস্তারিত জানার জন্য সুযোগ দেখুন.

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

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

আরও বিস্তারিত জানার জন্য পরীক্ষা Google Workspace অ্যাড-অন দেখুন।

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

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

Google Workspace অ্যাড-অনগুলি Google Workspace Marketplace- এ প্রকাশিত হয়। সর্বজনীনভাবে উপলব্ধ অ্যাড-অনগুলি প্রকাশ করার আগে অ্যাপ পর্যালোচনা সম্পূর্ণ করতে হবে।

আরো বিস্তারিত জানার জন্য পাবলিশিং Google Workspace অ্যাড-অন দেখুন।

Google Workspace অ্যাড-অন উদাহরণ

Google Workspace অ্যাড-অন সাইডবার

Google Workspace অ্যাড-অনগুলি কীভাবে তৈরি করা হয় তা বোঝার জন্য আপনাকে সাহায্য করার জন্য, Google Workspace "Cats" অ্যাড-অন কুইকস্টার্ট দেখায় যে কীভাবে একটি সাধারণ Google Workspaceঅ্যাড-অন তৈরি করতে হয়, যার মধ্যে হোমপেজ, কার্ড নেভিগেশন এবং তৃতীয়টির সাথে সংযোগগুলি রয়েছে। পার্টি সেবা। একবার আপনি কুইকস্টার্ট সম্পন্ন করলে, আপনি অ্যাড-অন ইনস্টল করতে পারেন এবং কোডটি নিয়ে পরীক্ষা করতে পারেন।