Google Apps Script দিয়ে একটি Google Chat অ্যাপ তৈরি করুন

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

চ্যাট অ্যাপ আপনাকে সরাসরি বার্তা পাঠাতে দেয় এবং আপনার বার্তাগুলিকে প্রতিধ্বনিত করে প্রতিক্রিয়া জানায়৷

নিম্নলিখিত চিত্রটি আর্কিটেকচার এবং মেসেজিং প্যাটার্ন দেখায়:

অ্যাপস স্ক্রিপ্টের সাথে বাস্তবায়িত একটি চ্যাট অ্যাপের আর্কিটেকচার।

পূর্ববর্তী চিত্রে, একটি অ্যাপস স্ক্রিপ্ট চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করা একজন ব্যবহারকারীর নিম্নলিখিত তথ্যের প্রবাহ রয়েছে:

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

উদ্দেশ্য

  • আপনার পরিবেশ সেট আপ করুন।
  • স্ক্রিপ্ট সেট আপ করুন।
  • Chat অ্যাপের জন্য একটি Google Workspace অ্যাড-অন কনফিগার করুন।
  • চ্যাট অ্যাপটি পরীক্ষা করুন।

পূর্বশর্ত

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

Google ক্লাউড কনসোলে আপনার ক্লাউড প্রকল্প খুলুন

যদি এটি ইতিমধ্যে খোলা না থাকে, তাহলে ক্লাউড প্রকল্পটি খুলুন যা আপনি এই নমুনার জন্য ব্যবহার করতে চান:

  1. Google ক্লাউড কনসোলে, একটি প্রকল্প নির্বাচন করুন পৃষ্ঠাতে যান।

    একটি ক্লাউড প্রকল্প নির্বাচন করুন

  2. আপনি যে Google ক্লাউড প্রকল্পটি ব্যবহার করতে চান সেটি নির্বাচন করুন। অথবা, প্রকল্প তৈরি করুন ক্লিক করুন এবং অন-স্ক্রীন নির্দেশাবলী অনুসরণ করুন। আপনি যদি একটি Google ক্লাউড প্রকল্প তৈরি করেন, তাহলে আপনাকে প্রকল্পটির জন্য বিলিং চালু করতে হতে পারে।

চ্যাট API চালু করুন

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

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

  1. Google ক্লাউড কনসোলে, মেনু > API এবং পরিষেবা > OAuth সম্মতি স্ক্রীনে যান।

    OAuth সম্মতি স্ক্রিনে যান

  2. ব্যবহারকারীর প্রকারের জন্য অভ্যন্তরীণ নির্বাচন করুন, তারপরে তৈরি করুন ক্লিক করুন।
  3. অ্যাপ রেজিস্ট্রেশন ফর্মটি পূরণ করুন, তারপর সংরক্ষণ করুন এবং চালিয়ে যান-এ ক্লিক করুন।

  4. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন এবং সেভ এবং কন্টিনিউ এ ক্লিক করতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য একটি অ্যাপ তৈরি করবেন, তখন আপনাকে অবশ্যই ব্যবহারকারীর ধরন পরিবর্তন করে External তে পরিবর্তন করতে হবে এবং তারপরে, আপনার অ্যাপের প্রয়োজনীয় অনুমোদনের সুযোগ যোগ করতে হবে।

  5. আপনার অ্যাপ নিবন্ধন সারাংশ পর্যালোচনা করুন. পরিবর্তন করতে, সম্পাদনা ক্লিক করুন। অ্যাপ নিবন্ধন ঠিক আছে বলে মনে হলে, ড্যাশবোর্ডে ফিরে যান ক্লিক করুন।

স্ক্রিপ্ট সেট আপ করুন

স্ক্রিপ্ট সেট আপ করতে, আপনি কুইকস্টার্ট প্রকল্পের একটি অনুলিপি তৈরি করুন এবং তারপরে অ্যাপস স্ক্রিপ্টে আপনার ক্লাউড প্রকল্প সেট করুন।

কুইকস্টার্ট প্রজেক্টের একটি কপি তৈরি করুন

  1. Google Chat Apps Script প্রকল্পে অ্যাড-অন খুলতে নিম্নলিখিত বোতামে ক্লিক করুন।
    প্রকল্প খুলুন
  2. ওভারভিউ-এ ক্লিক করুন।
  3. ওভারভিউ পৃষ্ঠায়, ক্লিক করুন একটি অনুলিপি তৈরি করার জন্য আইকন একটি অনুলিপি তৈরি করুন ।

  4. Apps স্ক্রিপ্ট প্রকল্পের আপনার কপির নাম দিন:

    1. অ্যাড-অন চ্যাট অ্যাপের অনুলিপিতে ক্লিক করুন।

    2. প্রকল্প শিরোনামে , Add-on Chat app টাইপ করুন

    3. পুনঃনামকরণ ক্লিক করুন।

ক্লাউড প্রকল্প নম্বর কপি করুন

  1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > সেটিংসে যান।

    IAM এবং অ্যাডমিন সেটিংসে যান

  2. প্রকল্প নম্বর ক্ষেত্রে, মানটি অনুলিপি করুন।

অ্যাপস স্ক্রিপ্ট প্রকল্পের ক্লাউড প্রকল্প সেট করুন

  1. চ্যাট অ্যাপ অ্যাপস স্ক্রিপ্ট প্রোজেক্টে, প্রোজেক্ট সেটিংসে ক্লিক করুন প্রকল্প সেটিংসের জন্য আইকন .
  2. Google ক্লাউড প্ল্যাটফর্ম (GCP) প্রকল্পের অধীনে, প্রকল্প পরিবর্তন করুন ক্লিক করুন।
  3. GCP প্রকল্প নম্বরে , Google ক্লাউড প্রকল্প নম্বর পেস্ট করুন।
  4. সেট প্রকল্প ক্লিক করুন.

আপনার কাছে এখন কার্যকরী অ্যাপ কোড রয়েছে যা আপনি চেষ্টা করে দেখতে পারেন (নিম্নলিখিত ধাপে বর্ণিত) এবং তারপর আপনার প্রয়োজনীয়তা পূরণের জন্য কাস্টমাইজ করুন।

আপনি যখন Apps স্ক্রিপ্ট প্রকল্প খুলবেন তখন আপনি সঠিক Google অ্যাকাউন্টে সাইন ইন করেছেন তা নিশ্চিত করুন৷ আপনি লক্ষ্য না করেই বর্তমান অ্যাকাউন্টটি কখনও কখনও আপনার ডিফল্ট অ্যাকাউন্টে স্যুইচ করতে পারে।

একটি পরীক্ষা স্থাপনা তৈরি করুন

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

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

  1. চ্যাট অ্যাপ অ্যাপস স্ক্রিপ্ট প্রোজেক্টে, Deploy > Test deployments এ ক্লিক করুন।
  2. পরবর্তী ধাপে ব্যবহারের জন্য হেড ডিপ্লয়মেন্ট আইডি কপি করুন এবং সম্পন্ন ক্লিক করুন।

অ্যাড-অন কনফিগার করুন

আপনার অ্যাপস স্ক্রিপ্ট স্থাপনা ব্যবহার করে, একটি অ্যাড-অন তৈরি করতে এবং Google চ্যাট অ্যাপ স্থাপন করতে এই পদক্ষেপগুলি অনুসরণ করুন:

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

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

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

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

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

চ্যাট অ্যাপটি পরীক্ষা করুন

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

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

    গুগল চ্যাটে যান

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

  4. ফলাফল থেকে আপনার চ্যাট অ্যাপ নির্বাচন করুন। একটি সরাসরি বার্তা খোলে।

  5. অ্যাপটির সাথে নতুন সরাসরি বার্তায়, Hello টাইপ করুন এবং enter টিপুন।

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

বিশ্বস্ত পরীক্ষক যোগ করতে এবং ইন্টারেক্টিভ বৈশিষ্ট্যগুলি পরীক্ষা করার বিষয়ে আরও জানতে, Google চ্যাট অ্যাপগুলির জন্য পরীক্ষা ইন্টারেক্টিভ বৈশিষ্ট্যগুলি দেখুন৷

সমস্যা সমাধান

যখন একটি Google চ্যাট অ্যাপ বা কার্ড একটি ত্রুটি ফেরত দেয়, তখন চ্যাট ইন্টারফেস "কিছু ভুল হয়েছে" বলে একটি বার্তা দেখায়। অথবা "আপনার অনুরোধ প্রক্রিয়া করতে অক্ষম।" কখনও কখনও চ্যাট UI কোনও ত্রুটি বার্তা প্রদর্শন করে না, তবে চ্যাট অ্যাপ বা কার্ড একটি অপ্রত্যাশিত ফলাফল তৈরি করে; উদাহরণস্বরূপ, একটি কার্ড বার্তা প্রদর্শিত নাও হতে পারে৷

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

পরিষ্কার করুন

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

  1. Google ক্লাউড কনসোলে, সম্পদ পরিচালনা পৃষ্ঠাতে যান। মেনু > আইএএম এবং অ্যাডমিন > সম্পদ পরিচালনা করুন ক্লিক করুন।

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

  2. প্রকল্প তালিকায়, আপনি যে প্রকল্পটি মুছতে চান সেটি নির্বাচন করুন এবং তারপরে মুছুন ক্লিক করুন।
  3. ডায়ালগে, প্রকল্প আইডি টাইপ করুন এবং তারপরে প্রকল্পটি মুছে ফেলতে শাট ডাউন ক্লিক করুন।