একটি Google চ্যাট অ্যাপ কনফিগার করুন

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস দেয়।

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে একটি Google Chat অ্যাপকে Google Workspace অ্যাড-অন হিসেবে কনফিগার এবং স্থাপন করতে হয়।

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

দ্রষ্টব্য: এই পৃষ্ঠাটি ব্যাখ্যা করে কিভাবে অ্যাপস স্ক্রিপ্ট বা একটি HTTP পরিষেবা ব্যবহার করে একটি চ্যাট অ্যাপ কনফিগার করতে হয়। ডায়ালগফ্লো এবং পাব/সাব অনুপলব্ধ৷ বিস্তারিত জানার জন্য, সীমাবদ্ধতা এবং পরিচিত সমস্যা দেখুন।

পূর্বশর্ত

HTTP

• Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
• একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
• OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
• নিম্নলিখিত Google Workspace API চালু করুন :
  • Google Chat API
  • Google Workspace অ্যাড-অন API
    Chat অ্যাপের ডিপ্লোয়মেন্ট তৈরি ও ম্যানেজ করতে আপনি Google Workspace অ্যাড-অন API ব্যবহার করতে পারবেন না। বিস্তারিত জানার জন্য, সীমাবদ্ধতা এবং পরিচিত সমস্যা দেখুন।
• একটি HTTP এন্ডপয়েন্ট যা আপনার চ্যাট অ্যাপের পরিষেবা আর্কিটেকচার হোস্ট করে।

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

• Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
• একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
• OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
• Google Chat API সক্ষম করুন ৷
• একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং উন্নত চ্যাট পরিষেবা চালু করুন।
• addons.chat অবজেক্ট এবং যেকোনো প্রয়োজনীয় স্কোপ ( oauthScopes ) বা HTTPS URL উপসর্গ ( urlFetchWhitelist ) যোগ করে ম্যানিফেস্টে চ্যাট কনফিগার করুন ।

আপনার চ্যাট অ্যাপের জন্য একটি প্রদর্শনের নাম, অবতার এবং বিবরণ বেছে নিন

চ্যাট অ্যাপের নাম, অবতার এবং বিবরণ Chat UI-তে ব্যবহারকারীদের কাছে প্রদর্শিত হয়। চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করতে, ব্যবহারকারীরা নিম্নলিখিত উপায়ে এই তথ্য দেখতে বা ব্যবহার করে:

• চ্যাট অ্যাপটিকে একটি স্পেসে যোগ করতে বা এটিকে একটি বার্তা পাঠাতে @উল্লেখ করুন।
• চ্যাট অ্যাপের মাধ্যমে একটি সরাসরি বার্তা খুঁজুন এবং শুরু করুন। অ্যাপস মেনুতে, সরাসরি বার্তা চ্যাট অ্যাপের নাম এবং অবতার প্রদর্শন করে।
• কম্পোজ বার থেকে, ব্যবহারকারীরা চ্যাট অ্যাপ ব্রাউজ করতে পারেন এবং তাদের নাম, অবতার এবং বিবরণ দেখতে পারেন।

আপনি একটি চ্যাট অ্যাপ কনফিগার করার আগে, আপনাকে অবশ্যই নিম্নলিখিত তথ্য প্রস্তুত করতে হবে:

মাঠ	বর্ণনা	বিন্যাস
অ্যাপের নাম	চ্যাট অ্যাপের প্রদর্শনের নাম।	25টি পর্যন্ত আলফানিউমেরিক অক্ষর
অবতার URL	যে ছবিটি আপনার চ্যাট অ্যাপের অবতার হিসেবে প্রদর্শিত হয়।	একটি বর্গাকার গ্রাফিক্স ইমেজ (PNG বা JPEG) নির্দেশ করে একটি HTTPS URL। প্রস্তাবিত আকার হল 256 বাই 256 পিক্সেল বা তার বেশি৷
বর্ণনা	চ্যাট অ্যাপের উদ্দেশ্যের একটি সংক্ষিপ্ত বিবরণ।	40টি পর্যন্ত আলফানিউমেরিক অক্ষর

নিম্নলিখিত বিভাগে, আপনি চ্যাট API-এর কনফিগারেশন সেটিংসে এই তথ্যটি উল্লেখ করেন।

Google ক্লাউড কনসোলে আপনার চ্যাট অ্যাপ কনফিগার করুন

আপনার চ্যাট অ্যাপের বিশদ বিবরণ থাকলে, আপনার ক্লাউড প্রকল্প খুলুন এবং চ্যাট এপিআই কনফিগার করুন:

1. Google ক্লাউড কনসোলে, চ্যাট API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:

   চ্যাট API কনফিগারেশন পৃষ্ঠায় যান

2. অ্যাপ্লিকেশন তথ্যের অধীনে, অ্যাপের নাম , অবতার URL এবং বর্ণনা ক্ষেত্রগুলি পূরণ করুন৷

3. ইন্টারেক্টিভ বৈশিষ্ট্যের অধীনে, অন পজিশনে ইন্টারেক্টিভ বৈশিষ্ট্যগুলি সক্ষম করুন ক্লিক করুন এবং নিম্নলিখিতগুলি সম্পূর্ণ করুন:

   1. কার্যকারিতার অধীনে, আপনার চ্যাট অ্যাপটি ইনস্টল এবং ব্যবহার করার জন্য উপলব্ধ করতে এক বা একাধিক চেকবক্স নির্বাচন করুন:

      • 1:1 বার্তা গ্রহণ করুন : ব্যবহারকারীরা ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে একটি নির্দিষ্ট স্থানে চ্যাট অ্যাপটি ইনস্টল করতে এবং বার্তা পাঠাতে পারেন।

      • স্পেস এবং গোষ্ঠী কথোপকথনে যোগ দিন : ব্যবহারকারীরা একাধিক ব্যক্তির সাথে স্পেসগুলিতে চ্যাট অ্যাপ যোগ করতে এবং ইন্টারঅ্যাক্ট করতে পারে।

   2. সংযোগ সেটিংসের অধীনে, আপনি চ্যাট থেকে ইভেন্ট অবজেক্টগুলি পেতে ব্যবহার করতে চান এমন আর্কিটেকচার নির্বাচন করুন:

      • একটি HTTP পরিষেবা ব্যবহার করতে, HTTP এন্ডপয়েন্ট URL নির্বাচন করুন এবং একটি URL প্রদান করুন।
      • একটি Google Apps Script প্রকল্প ব্যবহার করতে, Apps Script নির্বাচন করুন এবং প্রকল্পের জন্য একটি স্থাপনার ID প্রদান করুন৷
      সতর্কতা: অ্যাপস স্ক্রিপ্ট ডিপ্লোয়মেন্ট আইডি আগে থেকেই তৈরি করা থাকলে, ক্লাউড প্রোজেক্টটি একটি বিদ্যমান Google Workspace অ্যাড-অনের সাথে কানেক্ট করা আছে। আপনি Chat API-এ ডিপ্লয়মেন্ট আইডি আপডেট করলে, আপনার অ্যাড-অনের জন্য ডিপ্লয়মেন্ট আইডি আপডেট করা হয় এবং Google Workspace মার্কেটপ্লেসে আপনার তালিকাকে প্রভাবিত করতে পারে। আপনার অ্যাড-অন কনফিগারেশন পর্যালোচনা করতে, Google Workspace Marketplace ডকুমেন্টেশনে Google Workspace Marketplace SDK-এ আপনার অ্যাপ কনফিগার করুন দেখুন।

   3. ঐচ্ছিক: একাধিক এন্ডপয়েন্ট বা ফাংশনে ইভেন্ট অবজেক্ট পেতে, অ্যাডভান্সড সেটিংস > ট্রিগারগুলিতে যান এবং নিম্নলিখিত চ্যাট ট্রিগারগুলির জন্য কলব্যাক ফাংশনগুলি প্রদান বা আপডেট করুন:

      দ্রষ্টব্য: Apps স্ক্রিপ্টের জন্য, আপনি যদি ট্রিগারগুলি আপডেট না করেন, তাহলে আপনাকে অবশ্যই এই বিভাগে থাকা সংশ্লিষ্ট কলব্যাক ফাংশনগুলি ব্যবহার করতে হবে (যেমন onMessage , onAddedToSpace , এবং onRemovedFromSpace )।
      • ADDED_TO_SPACE : একজন ব্যবহারকারী একটি গ্রুপ কথোপকথন বা স্পেসে চ্যাট অ্যাপ যোগ করেন বা 1:1 বার্তার জন্য চ্যাট অ্যাপ ইনস্টল করেন।
      • বার্তা : একজন ব্যবহারকারী চ্যাট অ্যাপে একটি বার্তা পাঠান। উদাহরণস্বরূপ, চ্যাট অ্যাপে একটি সরাসরি বার্তা পাঠায় বা একাধিক ব্যক্তির সাথে একটি স্পেসে চ্যাট অ্যাপের @ উল্লেখ করে।
      • REMOVED_FROM_SPACE : একজন ব্যবহারকারী একটি স্পেস থেকে চ্যাট অ্যাপ আনইনস্টল বা সরিয়ে দেয়।

   4. ঐচ্ছিক: অন্যান্য ইন্টারেক্টিভ বৈশিষ্ট্য যোগ করুন যেমন স্ল্যাশ কমান্ড বা লিঙ্ক প্রিভিউ ।

   5. দৃশ্যমানতার অধীনে, আপনার ইমেল নির্দিষ্ট করুন যাতে আপনি Google Workspace মার্কেটপ্লেসে প্রকাশ করার আগে Chat অ্যাপ ইনস্টল ও পরীক্ষা করতে পারেন। আপনি আপনার Google Workspace সংস্থা থেকে সর্বাধিক পাঁচটি ব্যক্তি বা এক বা একাধিক Google গ্রুপ নির্দিষ্ট করতে পারেন।

4. ঐচ্ছিক: লগস এর অধীনে, Google ক্লাউড লগিং ব্যবহার করতে লগিং এর চেকবক্স নির্বাচন করুন। আরও তথ্যের জন্য, চ্যাট এপিআই ডকুমেন্টেশনে চ্যাট অ্যাপগুলির জন্য কোয়েরি ত্রুটি লগগুলি দেখুন৷

5. Save এ ক্লিক করুন।

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

বিদ্যমান Google Workspace অ্যাড-অনগুলির জন্য বিবেচনা

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

• ব্যক্তি এবং Google Workspace অ্যাডমিনিস্ট্রেটর উভয়কেই মার্কেটপ্লেস থেকে আপনার অ্যাড-অন ইনস্টল করতে সক্ষম হতে হবে। আপনি Google Workspace Marketplace SDK-এ এই ইনস্টলেশন সেটিংস কনফিগার করেন।
• ম্যানিফেস্টের addons.common অবজেক্টে অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য আপনি যে নাম এবং লোগো কনফিগার করেন তা চ্যাট অ্যাপগুলি ব্যবহার করে না।
• Google Workspace Marketplace-এ প্রকাশিত অ্যাড-অনগুলির জন্য, আপনি Google Chat API কনফিগারেশন সেটিংসে কোনো পরিবর্তনের খসড়া সংরক্ষণ করতে পারবেন না। আপনি চ্যাট API কনফিগারেশন সেটিংস আপডেট এবং সংরক্ষণ করার পরে, আপডেট করা চ্যাট অ্যাপটি সমস্ত বিদ্যমান ব্যবহারকারীদের জন্য উপলব্ধ। আপনার মার্কেটপ্লেস তালিকা আপডেট করতে, আপনি কোনো পরিবর্তন জমা দেওয়ার আগে একটি খসড়া তৈরি করতে পারেন।

• আপনি যদি অ্যাপস স্ক্রিপ্ট ব্যবহার করে আপনার অ্যাড-অন তৈরি করেন:

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

• আপনি যদি HTTP পরিষেবা ব্যবহার করে আপনার অ্যাড-অন তৈরি করে থাকেন, তাহলে Google Workspace অ্যাড-অন API ব্যবহার করে ম্যানিফেস্ট এবং ডিপ্লোয়মেন্টে যেকোনও চ্যাট অ্যাপ কনফিগারেশনের বিবরণ বাদ দিন। আপনি Google Workspace Marketplace SDK-এ যে HTTP ডিপ্লোয়মেন্টগুলি উল্লেখ করেছেন তা শুধুমাত্র অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য ব্যবহার করা হয়।

সম্পর্কিত বিষয়

• চ্যাট API-এ অ্যাক্সেস পরিচালনা করতে, Google Chat API ডকুমেন্টেশনে Google Chat API কনফিগার করুন দেখুন।
• Google চ্যাট অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্য পরীক্ষা করুন
• Google Chat অ্যাপ প্রকাশ করুন