Google Apps স্ক্রিপ্ট ব্যবহার করে Google Chat অ্যাপ তৈরি করা

এই পৃষ্ঠায় Google Apps Script ব্যবহার করে কীভাবে Google Chat অ্যাপ তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে। Chat অ্যাপ আপনাকে সরাসরি মেসেজ করতে এবং আপনার মেসেজ ইকো করে উত্তর দিতে দেয়।

নিচের ডায়াগ্রামে আর্কিটেকচার ও মেসেজিং প্যাটার্ন দেখানো হয়েছে:

পূর্ববর্তী ডায়াগ্রামে, কোনও ব্যবহারকারী Apps Script Chat অ্যাপের সাথে ইন্টার‍্যাক্ট করলে, তথ্যের ফ্লো নিম্নলিখিতভাবে হয়:

1. কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান, সেটি সরাসরি মেসেজ বা Chat স্পেস হতে পারে।
2. Apps Script-এ প্রয়োগ করা Chat অ্যাপের লজিক, যা Google Cloud-এ থাকে, সেটি মেসেজ পায় ও প্রসেস করে।
3. ঐচ্ছিকভাবে, Chat অ্যাপের লজিক Google Workspace পরিষেবার সাথে ইন্টিগ্রেট করতে পারে, যেমন Calendar বা Sheets অথবা অন্যান্য Google পরিষেবা, যেমন Google Maps বা YouTube.
4. Chat অ্যাপের লজিক Chat-এর Chat অ্যাপ পরিষেবায় একটি উত্তর পাঠায়।
5. উত্তরটি ব্যবহারকারীকে ডেলিভার করা হয়।

উদ্দেশ্য

• আপনার এনভায়রনমেন্ট সেট-আপ করুন।
• স্ক্রিপ্ট সেট-আপ করুন।
• Chat অ্যাপ কনফিগার করুন।
• Chat অ্যাপ পরীক্ষা করুন।

পূর্বশর্ত

• Business বা Enterprise Google Workspace অ্যাকাউন্ট, যার Google Chat-এ অ্যাক্সেস আছে।
• Google Cloud প্রোজেক্ট। এটি তৈরি করতে, Google Cloud প্রোজেক্ট তৈরি করুন লিঙ্কে দেখুন।

আপনার পরিবেশ সেট-আপ করা

Google Cloud Console-এ আপনার Cloud প্রোজেক্ট খুলুন

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

1. Google Cloud Console-এ, একটি প্রোজেক্ট বেছে নিন পেজে যান।

   ক্লাউড প্রোজেক্ট বেছে নিন

2. আপনি যে Google Cloud প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন। অথবা, প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করে স্ক্রিনে দেখানো নির্দেশাবলী অনুসরণ করুন। আপনি Google Cloud প্রোজেক্ট তৈরি করলে, আপনাকে হয়ত প্রোজেক্টের জন্য বিলিং চালু করতে হবে।

Chat API চালু করুন

Google API ব্যবহার করার আগে, আপনাকে Google Cloud প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি Google Cloud প্রোজেক্টে এক বা একাধিক API চালু করতে পারবেন।

• Google Cloud Console-এ, Google Chat API চালু করুন।

  API চালু করুন

OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করা

OAuth 2.0 ব্যবহার করা সব অ্যাপের জন্য সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন। আপনার অ্যাপের OAuth সম্মতি স্ক্রিন কনফিগার করা হলে, ব্যবহারকারী ও অ্যাপ পর্যালোচকদের কী দেখানো হবে তা নির্ধারণ করা হয় এবং আপনার অ্যাপ রেজিস্টার করা হয় যাতে আপনি পরে এটি প্রকাশ করতে পারেন।

1. Google API Console-এ, 'মেনু > Google Auth প্ল্যাটফর্ম > ব্র্যান্ডিং' বিকল্পে যান।

   ব্র্যান্ডিংয়ে যান

2. আপনি যদি আগে থেকেই Google Auth প্ল্যাটফর্ম কনফিগার করে থাকেন, তাহলে ব্র্যান্ডিং, দর্শক এবং ডেটা অ্যাক্সেস বিকল্পে গিয়ে নিম্নলিখিত OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেটিংস কনফিগার করতে পারবেন। আপনি যদি Google Auth প্ল্যাটফর্ম এখনও কনফিগার করা হয়নি লেখা মেসেজ দেখতে পান, তাহলে শুরু করুন বিকল্পে ক্লিক করুন:
1. অ্যাপ সম্পর্কিত তথ্য বিকল্পের মধ্যে, অ্যাপের নাম বিকল্পে অ্যাপের নাম লিখুন।
2. ব্যবহারকারীর সহায়তা সংক্রান্ত ইমেল বিকল্পে, এমন একটি সহায়তা ইমেল আইডি বেছে নিন যেখানে ব্যবহারকারীরা তাদের সম্মতি সম্পর্কে প্রশ্ন থাকলে আপনার সাথে যোগাযোগ করতে পারবেন।
3. পরবর্তী বিকল্পে ক্লিক করুন।
4. দর্শক বিকল্পের মধ্যে, ইন্টার্নাল বিকল্প বেছে নিন।
5. পরবর্তী বিকল্পে ক্লিক করুন।
6. যোগাযোগের তথ্য বিকল্পের মধ্যে, এমন একটি ইমেল আইডি লিখুন যেখানে আপনার প্রোজেক্টে কোনও পরিবর্তন হলে আপনাকে জানানো যাবে।
7. পরবর্তী বিকল্পে ক্লিক করুন।
8. সম্পূর্ণ করুন বিকল্পের মধ্যে, Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং আপনি সম্মতি জানালে, আমি Google API পরিষেবা সংক্রান্ত ব্যবহারকারীর ডেটা নীতিতে সম্মতি জানাচ্ছি বিকল্প বেছে নিন।
9. চালিয়ে যান বিকল্পে ক্লিক করুন।
10. তৈরি করুন বিকল্পে ক্লিক করুন।
3. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য কোনও অ্যাপ তৈরি করলে, আপনাকে অবশ্যই ব্যবহারকারীর ধরন পরিবর্তন করে এক্সটার্নাল করতে হবে। তারপরে আপনার অ্যাপের প্রয়োজনীয় অনুমোদনের স্কোপ যোগ করুন। আরও জানতে, সম্পূর্ণ OAuth সম্মতি কনফিগার করুন গাইড দেখুন।

স্ক্রিপ্ট সেট-আপ করা

স্ক্রিপ্ট সেট-আপ করতে, আপনি Apps Script শুরু করা যাক পৃষ্ঠা থেকে Chat অ্যাপ টেমপ্লেট ব্যবহার করেন।

Apps স্ক্রিপ্ট প্রোজেক্ট তৈরি করা

1. Apps Script-এর শুরু করা পৃষ্ঠা থেকে, Google Workspace অ্যাড-অন স্টার্টার বিকল্পে যান এবং Chat অ্যাপ টেমপ্লেটে ক্লিক করুন:

   Chat অ্যাপ টেমপ্লেট খুলুন

2. নতুন যে Apps Script প্রোজেক্ট খুলবে, সেটির নাম দিন:

   1. শিরোনামহীন প্রোজেক্ট বিকল্পে ক্লিক করুন।

   2. প্রোজেক্টের নাম বক্সে Quickstart app লিখুন।

   3. নাম পরিবর্তন করুন বিকল্পে ক্লিক করুন।

ভবিষ্যতে, আপনি নির্দিষ্ট Google API ব্যবহার করতে বা আপনার অ্যাপ প্রকাশ করতে চাইলে, আপনাকে অবশ্যই নিজের Apps Script প্রোজেক্টের সাথে Cloud প্রোজেক্ট অ্যাসোসিয়েট করতে হবে। এই নির্দেশিকার জন্য, আপনাকে এটি করতে হবে না। আরও জানতে, Google Cloud প্রোজেক্ট নির্দেশিকা দেখুন।

টেস্ট ডিপ্লয়মেন্ট তৈরি করা

এই Apps Script প্রোজেক্টের জন্য আপনার একটি ডিপ্লয়মেন্ট আইডি প্রয়োজন, যাতে আপনি এটি পরবর্তী ধাপে ব্যবহার করতে পারেন।

হেড ডিপ্লয়মেন্ট আইডি পেতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. Chat অ্যাপের Apps স্ক্রিপ্ট প্রোজেক্টে, ডিপ্লয় করুন > ডিপ্লয়মেন্ট পরীক্ষা করুন বিকল্পে ক্লিক করুন।
2. পরবর্তী ধাপে ব্যবহার করার জন্য হেড ডিপ্লয়মেন্ট আইডি কপি করুন এবং হয়ে গেছে বিকল্পে ক্লিক করুন।

Chat অ্যাপ কনফিগার করা

Google Chat অ্যাপ কনফিগার করতে এইসব ধাপ অনুসরণ করুন:

1. API কনসোলে গিয়ে Google Chat API সার্চ করুন এবং Google Chat API-তে ক্লিক করুন।
2. ম্যানেজ করুন বিকল্পে ক্লিক করুন।

3. কনফিগারেশন বিকল্পে ক্লিক করে Chat অ্যাপ সেট-আপ করুন:

   1. অ্যাপের নাম ফিল্ডে, Quickstart app লিখুন।
   2. অবতার URL ফিল্ডে, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
   3. বিবরণ ফিল্ডে, Quickstart app লিখুন।
   4. কার্যকারিতা বিকল্পের মধ্যে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
   5. কানেকশন সেটিংস বিকল্পের মধ্যে, অ্যাপ স্ক্রিপ্ট প্রোজেক্ট বিকল্প বেছে নিন।
   6. ডেপ্লয়মেন্ট আইডি ফিল্ডে, হেড ডেপ্লয়মেন্ট আইডি পেস্ট করুন যেটি আপনি আগে কপি করেছিলেন।
   7. দৃশ্যমানতা বিকল্পের মধ্যে, আপনার ডোমেনের নির্দিষ্ট লোকজন ও গ্রুপ বিকল্প বেছে নিন এবং আপনার ইমেল আইডি লিখুন।

4. সেভ করুন বিকল্পে ক্লিক করুন।

Chat অ্যাপ মেসেজের উত্তর দেওয়ার জন্য প্রস্তুত।

Chat অ্যাপ পরীক্ষা করা

আপনার Chat অ্যাপ পরীক্ষা করতে, Chat অ্যাপের মাধ্যমে সরাসরি মেসেজ স্পেস খুলুন এবং একটি মেসেজ পাঠান:

1. আপনি বিশ্বস্ত পরীক্ষক হিসেবে নিজেকে যোগ করার সময় যে Google Workspace অ্যাকাউন্ট প্রদান করেছিলেন সেটি ব্যবহার করে Google Chat খুলুন।

   Google Chat-এ যান

2. নতুন চ্যাট বিকল্পে ক্লিক করুন।
3. ১ বা একাধিক লোকজনকে যোগ করুন ফিল্ডে, আপনার Chat অ্যাপের নাম টাইপ করুন।

4. ফলাফল থেকে আপনার Chat অ্যাপ বেছে নিন। সরাসরি মেসেজ খুলে যায়।

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

5. অ্যাপের সাথে নতুন সরাসরি মেসেজে, Hello টাইপ করে enter প্রেস করুন।

   Chat অ্যাপটি যোগ করার জন্য আপনাকে ধন্যবাদ জানায় এবং আপনার মেসেজটি প্রতিধ্বনিত করে।

বিশ্বস্ত পরীক্ষক যোগ করতে এবং ইন্ট্যার‍্যাক্টিভ ফিচার পরীক্ষা করা সম্পর্কে আরও জানতে, Google Chat অ্যাপের জন্য ইন্ট্যার‍্যাক্টিভ ফিচার পরীক্ষা করুন দেখুন।

সমস্যার সমাধান করুন

Google Chat অ্যাপ বা কার্ড কোনও সমস্যার মেসেজ দেখালে, Chat ইন্টারফেস "কিছু সমস্যা হয়েছে" লেখা মেসেজ দেখায়। অথবা "আপনার অনুরোধ প্রসেস করা যায়নি" কখনও কখনও Chat UI কোনও সমস্যার মেসেজ না দেখালেও, Chat অ্যাপ বা কার্ড অপ্রত্যাশিত ফলাফল দেয়; যেমন, কার্ড মেসেজ দেখানো নাও হতে পারে।

যদিও Chat UI-তে কোনও সমস্যার মেসেজ নাও দেখাতে পারে, Chat অ্যাপের জন্য সমস্যা লগ করার সুবিধা চালু করা থাকলে, সমস্যার বিবরণ সহ মেসেজ ও লগ ডেটা আপনাকে সমস্যা সমাধান করতে সাহায্য করার জন্য উপলভ্য থাকে। দেখতে, ডিবাগ করতে এবং সমস্যার সমাধান করতে সাহায্য পেতে, Google Chat সংক্রান্ত সমস্যার সমাধান ও তা ঠিক করা দেখুন।

অপ্রয়োজনীয়গুলি মুছুন

এই টিউটোরিয়ালে ব্যবহৃত রিসোর্সের জন্য আপনার Google Cloud অ্যাকাউন্টে চার্জ যাতে না লাগে, তার জন্য আমরা Cloud প্রোজেক্টটি মুছে দেওয়ার সাজেস্ট করি।

সতর্কতা: কোনও প্রোজেক্ট মুছে দিলে নিম্নলিখিত প্রভাব পড়ে:

• প্রোজেক্টের সবকিছু মুছে যায়। এই টিউটোরিয়ালের জন্য আপনি আগে থেকে থাকা কোনও প্রোজেক্ট ব্যবহার করে থাকলে, সেটি মুছে দেওয়ার সময় প্রোজেক্টে আপনার করা অন্যান্য কাজও মুছে যাবে।
• কাস্টম প্রোজেক্ট আইডি হারিয়ে গেছে। এই প্রোজেক্ট তৈরি করার সময়, আপনি হয়ত একটি কাস্টম প্রোজেক্ট আইডি তৈরি করেছেন যা ভবিষ্যতে ব্যবহার করতে চান। প্রোজেক্ট আইডি ব্যবহার করে এমন URL, যেমন appspot.com-এ থাকা URL, সেভ করতে, সম্পূর্ণ প্রোজেক্ট মুছে দেওয়ার পরিবর্তে প্রোজেক্টের মধ্যে বেছে নেওয়া রিসোর্স মুছে দিন।

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

1. Google API কনসোলে, রিসোর্স ম্যানেজ করুন পৃষ্ঠায় যান। মেনু > IAM ও অ্যাডমিন > রিসোর্স ম্যানেজ করুন বিকল্পে ক্লিক করুন।

   রিসোর্স ম্যানেজারে যান

2. প্রোজেক্টের তালিকা থেকে, যে প্রোজেক্টটি মুছতে চান সেটি বেছে নিন এবং তারপরে মুছুন বিকল্পে ক্লিক করুন।
3. ডায়ালগে, প্রোজেক্ট আইডি টাইপ করুন এবং তারপর প্রোজেক্ট মুছে দিতে বন্ধ করুন বিকল্পে ক্লিক করুন ।

পরবর্তী ধাপ

• ইন্টার‍্যাক্টিভ কার্ড তৈরি করা–কার্ড মেসেজে একটি নির্দিষ্ট লেআউট, বোতামের মতো ইন্টার‍্যাক্টিভ UI এলিমেন্ট এবং ছবির মতো রিচ মিডিয়া থাকে। বিস্তারিত তথ্য দেখাতে, ব্যবহারকারীদের থেকে তথ্য সংগ্রহ করতে এবং পরবর্তী পদক্ষেপ নেওয়ার ব্যাপারে ব্যবহারকারীদের গাইড করতে কার্ড মেসেজ ব্যবহার করুন।
• কমান্ডের উত্তর দেওয়া–কমান্ড ব্যবহারকারীদের আপনার Chat অ্যাপের মূল ফিচার খুঁজে পেতে ও ব্যবহার করতে সাহায্য করে।
• ডায়ালগ লঞ্চ করা–ডায়ালগ হল উইন্ডো-ভিত্তিক, কার্ড-ভিত্তিক ইন্টারফেস যা আপনার অ্যাপ ব্যবহারকারীর সাথে ইন্টার‍্যাক্ট করার জন্য খুলতে পারে। একাধিক কার্ড ক্রমশ একটার সাথে আরেকটা যোগ করা যায়, যা ব্যবহারকারীদের ফর্মের ডেটা পূরণ করার মতো একাধিক ধাপ সম্পূর্ণ করতে সাহায্য করে।
• কোডল্যাব: আরও উন্নত চ্যাট অ্যাপ তৈরি করতে চান? প্রতিক্রিয়া দেখুন কোডল্যাব থেকে চ্যাট অ্যাপ Gemini-র সাহায্যে Google Chat-এর জন্য অ্যাপ তৈরি করা।

অ্যাড-অন নয় এমন চ্যাট অ্যাপ: Google Apps Script-এর সাহায্যে Google Chat অ্যাপ তৈরি করা

Apps Script ব্যবহার করে Google Workspace অ্যাড-অন নয় এমন Chat অ্যাপ তৈরি করতে, টেমপ্লেট থেকে স্ক্রিপ্ট তৈরি করতে এবং অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করতে এইসব ধাপ অনুসরণ করুন।

টেমপ্লেট থেকে স্ক্রিপ্ট তৈরি করা

1. Apps Script শুরু করা পৃষ্ঠায় যান।
2. পৃষ্ঠার সবচেয়ে উপরে চ্যাট অ্যাপ টেমপ্লেটে ক্লিক করুন।

3. নামবিহীন প্রোজেক্ট বিকল্পে ক্লিক করুন, Quickstart app টাইপ করুন এবং নাম পরিবর্তন করুন বিকল্পে ক্লিক করুন।

   ভবিষ্যতে, আপনি যদি নির্দিষ্ট Google API ব্যবহার করতে চান বা আপনার অ্যাপ প্রকাশ করতে চান, তাহলে আপনাকে অবশ্যই নিজের Cloud প্রোজেক্টকে Apps Script প্রোজেক্টের সাথে যুক্ত করতে হবে। এই নির্দেশিকার জন্য, আপনাকে এটি করতে হবে না। আরও জানতে, Google Cloud প্রোজেক্ট নির্দেশিকা দেখুন।

4. Chat অ্যাপের Apps স্ক্রিপ্ট প্রোজেক্টে, ডিপ্লয় করুন > ডিপ্লয়মেন্ট পরীক্ষা করুন বিকল্পে ক্লিক করুন।

5. পরবর্তী ধাপে ব্যবহারের জন্য হেড ডিপ্লয়মেন্ট আইডি কপি করুন এবং হয়ে গেছে বিকল্পে ক্লিক করুন।

অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করা

API কনসোল থেকে অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করুন:

1. API কনসোলে, Google Chat API সার্চ করুন এবং Google Chat API-তে ক্লিক করুন।
2. ম্যানেজ করুন বিকল্পে ক্লিক করুন।

3. কনফিগারেশন বিকল্পে ক্লিক করুন এবং অ্যাড-অন নয় এমন Chat অ্যাপ সেট-আপ করুন:

   1. এই চ্যাট অ্যাপকে Google Workspace অ্যাড-অন হিসেবে তৈরি করো বিকল্পটি বাতিল করো। আপনাকে কনফার্ম করতে বলে একটি ডায়ালগ খুলবে। ডায়ালগে, বন্ধ করুন বিকল্পে ক্লিক করুন।
   2. অ্যাপের নাম ফিল্ডে, Quickstart app লিখুন।
   3. অবতার URL ফিল্ডে, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
   4. বিবরণ ফিল্ডে, Quickstart app লিখুন।
   5. কার্যকারিতা বিকল্পের মধ্যে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
   6. কানেকশন সেটিংস বিকল্পের মধ্যে, Apps স্ক্রিপ্ট বেছে নিন।
   7. ডেপ্লয়মেন্ট আইডি ফিল্ডে, হেড ডেপ্লয়মেন্ট আইডি পেস্ট করুন যেটি আপনি আগে কপি করেছিলেন।
   8. দৃশ্যমানতা বিকল্পের মধ্যে, আপনার ডোমেনের নির্দিষ্ট লোকজন ও গ্রুপ বিকল্প বেছে নিন এবং আপনার ইমেল আইডি লিখুন।

4. সেভ করুন বিকল্পে ক্লিক করুন।