এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে যে কীভাবে Google Apps Script ব্যবহার করে Google Chat-এ কাজ করে এমন একটি Google Workspace অ্যাড-অন তৈরি করবেন।
চ্যাট অ্যাপ আপনাকে সরাসরি বার্তা পাঠাতে এবং আপনার বার্তাগুলি প্রতিধ্বনি করে উত্তর দিতে দেয়।
নিম্নলিখিত চিত্রটি স্থাপত্য এবং বার্তাপ্রেরণের ধরণ দেখায়:
পূর্ববর্তী চিত্রে, একজন ব্যবহারকারী অ্যাপস স্ক্রিপ্ট চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করছেন এবং তার তথ্যের প্রবাহ নিম্নরূপ:
- একজন ব্যবহারকারী চ্যাট অ্যাপে একটি বার্তা পাঠান, হয় সরাসরি বার্তায় অথবা চ্যাট স্পেসে।
- গুগল ক্লাউডে থাকা অ্যাপস স্ক্রিপ্টে বাস্তবায়িত চ্যাট অ্যাপ লজিক বার্তা গ্রহণ এবং প্রক্রিয়া করে।
- ঐচ্ছিকভাবে, চ্যাট অ্যাপ লজিকটি Google Workspace পরিষেবা, যেমন ক্যালেন্ডার বা শিট, অথবা Google Maps বা YouTube-এর মতো অন্যান্য Google পরিষেবার সাথে একীভূত হতে পারে।
- চ্যাট অ্যাপ লজিক চ্যাটে চ্যাট অ্যাপ পরিষেবাতে একটি প্রতিক্রিয়া পাঠায়।
- প্রতিক্রিয়া ব্যবহারকারীর কাছে পৌঁছে দেওয়া হয়।
উদ্দেশ্য
- তোমার পরিবেশ ঠিক করো।
- স্ক্রিপ্ট সেট আপ করুন।
- Chat অ্যাপের জন্য একটি Google Workspace অ্যাড-অন কনফিগার করুন।
- চ্যাট অ্যাপটি পরীক্ষা করে দেখুন।
পূর্বশর্ত
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- একটি গুগল ক্লাউড প্রকল্প। একটি তৈরি করতে, একটি গুগল ক্লাউড প্রকল্প তৈরি করুন দেখুন।
আপনার পরিবেশ সেট আপ করুন
গুগল ক্লাউড কনসোলে আপনার ক্লাউড প্রোজেক্ট খুলুন।
যদি এটি ইতিমধ্যে খোলা না থাকে, তাহলে এই নমুনার জন্য আপনি যে ক্লাউড প্রকল্পটি ব্যবহার করতে চান তা খুলুন:
- গুগল ক্লাউড কনসোলে, একটি প্রকল্প নির্বাচন করুন পৃষ্ঠায় যান।
- আপনি যে Google Cloud প্রকল্পটি ব্যবহার করতে চান তা নির্বাচন করুন। অথবা, প্রকল্প তৈরি করুন ক্লিক করুন এবং অন-স্ক্রীন নির্দেশাবলী অনুসরণ করুন। আপনি যদি একটি Google Cloud প্রকল্প তৈরি করেন, তাহলে আপনাকে প্রকল্পের জন্য বিলিং চালু করতে হতে পারে।
চ্যাট এপিআই চালু করুন
গুগল এপিআই ব্যবহার করার আগে, আপনাকে গুগল ক্লাউড প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি গুগল ক্লাউড প্রোজেক্টে এক বা একাধিক এপিআই চালু করতে পারেন।গুগল ক্লাউড কনসোলে, গুগল চ্যাট এপিআই সক্ষম করুন।
OAuth সম্মতি স্ক্রিন কনফিগার করুন
OAuth 2.0 ব্যবহার করা সমস্ত অ্যাপের জন্য একটি সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন। আপনার অ্যাপের OAuth সম্মতি স্ক্রিন কনফিগার করার মাধ্যমে ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কী প্রদর্শিত হবে তা সংজ্ঞায়িত করা হয় এবং আপনার অ্যাপটি নিবন্ধিত হয় যাতে আপনি পরে এটি প্রকাশ করতে পারেন।
- গুগল ক্লাউড কনসোলে, মেনু > এ যানGoogle Auth platform > ব্র্যান্ডিং ।
- যদি আপনি ইতিমধ্যেই কনফিগার করে থাকেন Google Auth platform, আপনি ব্র্যান্ডিং , অডিয়েন্স এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth কনসেন্ট স্ক্রিন সেটিংস কনফিগার করতে পারেন। যদি আপনি এমন একটি বার্তা দেখতে পান যা বলে Google Auth platform এখনও কনফিগার করা হয়নি , শুরু করুন ক্লিক করুন:
- অ্যাপ তথ্য এর অধীনে, অ্যাপের নামে , অ্যাপটির জন্য একটি নাম লিখুন।
- ব্যবহারকারীর সহায়তা ইমেল বিভাগে, এমন একটি সহায়তা ইমেল ঠিকানা বেছে নিন যেখানে ব্যবহারকারীদের সম্মতি সম্পর্কে প্রশ্ন থাকলে তারা আপনার সাথে যোগাযোগ করতে পারবেন।
- পরবর্তী ক্লিক করুন।
- অডিয়েন্স এর অধীনে, অভ্যন্তরীণ নির্বাচন করুন।
- পরবর্তী ক্লিক করুন।
- যোগাযোগের তথ্য এর অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে অবহিত করা যেতে পারে।
- পরবর্তী ক্লিক করুন।
- Finish এর অধীনে, Google API পরিষেবা ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে আমি Google API পরিষেবাগুলিতে সম্মত: ব্যবহারকারীর ডেটা নীতি নির্বাচন করুন।
- চালিয়ে যান ক্লিক করুন।
- তৈরি করুন ক্লিক করুন।
- আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য একটি অ্যাপ তৈরি করবেন, তখন আপনাকে ব্যবহারকারীর ধরণটি External এ পরিবর্তন করতে হবে। তারপর আপনার অ্যাপের জন্য প্রয়োজনীয় অনুমোদনের স্কোপগুলি যোগ করুন। আরও জানতে, সম্পূর্ণ Configure OAuth সম্মতি নির্দেশিকাটি দেখুন।
স্ক্রিপ্ট সেট আপ করুন
স্ক্রিপ্ট সেট আপ করার জন্য, আপনাকে অ্যাপস স্ক্রিপ্ট শুরু করার পৃষ্ঠা থেকে চ্যাট অ্যাপ টেমপ্লেটটি ব্যবহার করতে হবে এবং তারপর স্ক্রিপ্টটিকে আপনার ক্লাউড প্রকল্পের সাথে সংযুক্ত করতে হবে।
অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি করুন
অ্যাপস স্ক্রিপ্টের শুরু করার পৃষ্ঠা থেকে, অ্যাড-অন স্টার্টারে যান এবং চ্যাট অ্যাপ টেমপ্লেটটিতে ক্লিক করুন:
নতুন যে অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলবে, সেখানে প্রজেক্টটির নাম দিন:
শিরোনামহীন প্রকল্পে ক্লিক করুন।
প্রজেক্টের শিরোনামে ,
Add-on Chat appটাইপ করুন।পুনঃনামকরণ ক্লিক করুন।
ক্লাউড প্রজেক্ট নম্বরটি কপি করুন
- গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > সেটিংস এ যান।
- প্রজেক্ট নম্বর ক্ষেত্রে, মানটি অনুলিপি করুন।
অ্যাপস স্ক্রিপ্ট প্রজেক্টের ক্লাউড প্রজেক্ট সেট করুন
- চ্যাট অ্যাপ অ্যাপস স্ক্রিপ্ট প্রজেক্টে, প্রজেক্ট সেটিংসে ক্লিক করুন।
. - গুগল ক্লাউড প্ল্যাটফর্ম (জিসিপি) প্রজেক্টের অধীনে, প্রজেক্ট পরিবর্তন করুন এ ক্লিক করুন।
- GCP প্রজেক্ট নম্বরে , Google Cloud প্রজেক্ট নম্বরটি পেস্ট করুন।
- প্রজেক্ট সেট করুন এ ক্লিক করুন।
এখন আপনার কাছে একটি কার্যকরী অ্যাপ কোড আছে যা আপনি চেষ্টা করে দেখতে পারেন (নিম্নলিখিত ধাপগুলিতে বর্ণিত হিসাবে) এবং তারপর আপনার প্রয়োজনীয়তা পূরণের জন্য কাস্টমাইজ করুন।
অ্যাপস স্ক্রিপ্ট প্রজেক্ট খোলার সময় নিশ্চিত করুন যে আপনি সঠিক গুগল অ্যাকাউন্টে সাইন ইন করেছেন। বর্তমান অ্যাকাউন্টটি কখনও কখনও আপনার অজান্তেই আপনার ডিফল্ট অ্যাকাউন্টে স্যুইচ করতে পারে।
একটি পরীক্ষামূলক স্থাপনা তৈরি করুন
এই অ্যাপস স্ক্রিপ্ট প্রজেক্টের জন্য আপনার একটি ডিপ্লয়মেন্ট আইডি প্রয়োজন, যাতে আপনি পরবর্তী ধাপে এটি ব্যবহার করতে পারেন।
হেড ডিপ্লয়মেন্ট আইডি পেতে, নিম্নলিখিতগুলি করুন:
- চ্যাট অ্যাপ অ্যাপস স্ক্রিপ্ট প্রজেক্টে, Deploy > Test deployments এ ক্লিক করুন।
- পরবর্তী ধাপে ব্যবহারের জন্য হেড ডিপ্লয়মেন্ট আইডি কপি করুন এবং সম্পন্ন ক্লিক করুন।
অ্যাড-অন কনফিগার করুন
আপনার অ্যাপস স্ক্রিপ্ট ডিপ্লয়মেন্ট ব্যবহার করে, একটি অ্যাড-অন তৈরি করতে এবং গুগল চ্যাট অ্যাপ ডিপ্লয় করতে এই ধাপগুলি অনুসরণ করুন:
- কনসোলে ,
Google Chat APIঅনুসন্ধান করুন এবং Google Chat API এ ক্লিক করুন। - পরিচালনা করুন-এ ক্লিক করুন।
কনফিগারেশনে ক্লিক করুন এবং চ্যাট অ্যাপ সেট আপ করুন:
- অ্যাপের নাম ক্ষেত্রে,
Add-on Chat appলিখুন। - Avatar URL ক্ষেত্রে,
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.pngলিখুন। - বর্ণনা ক্ষেত্রে,
Add-on Chat appলিখুন। - কার্যকারিতার অধীনে, Join spaces and group conversations নির্বাচন করুন।
- সংযোগ সেটিংসের অধীনে, অ্যাপস স্ক্রিপ্ট প্রজেক্ট নির্বাচন করুন।
- ডিপ্লয়মেন্ট আইডি ফিল্ডে, আপনার পূর্বে কপি করা হেড ডিপ্লয়মেন্ট আইডিটি পেস্ট করুন।
- দৃশ্যমানতার অধীনে, আপনার ডোমেনের নির্দিষ্ট ব্যক্তি এবং গোষ্ঠী নির্বাচন করুন এবং আপনার ইমেল লিখুন।
- অ্যাপের নাম ক্ষেত্রে,
সংরক্ষণ করুন ক্লিক করুন।
চ্যাট অ্যাপটি মেসেজের উত্তর দেওয়ার জন্য প্রস্তুত।
চ্যাট অ্যাপটি পরীক্ষা করুন
আপনার চ্যাট অ্যাপটি পরীক্ষা করতে, চ্যাট অ্যাপের মাধ্যমে একটি সরাসরি বার্তা স্থান খুলুন এবং একটি বার্তা পাঠান:
বিশ্বস্ত পরীক্ষক হিসেবে নিজেকে যোগ করার সময় যে Google Workspace অ্যাকাউন্টটি দিয়েছিলেন, সেটি ব্যবহার করে Google Chat খুলুন।
- নতুন চ্যাট ক্লিক করুন।
- ১ বা তার বেশি লোক যোগ করুন ফিল্ডে, আপনার চ্যাট অ্যাপের নাম টাইপ করুন।
ফলাফল থেকে আপনার চ্যাট অ্যাপটি নির্বাচন করুন। একটি সরাসরি বার্তা খুলবে।
অ্যাপের নতুন সরাসরি বার্তায়,
Helloটাইপ করুন এবংenterটিপুন।চ্যাট অ্যাপটি এটি যোগ করার জন্য আপনাকে ধন্যবাদ এবং আপনার বার্তার প্রতিধ্বনি করে।
বিশ্বস্ত পরীক্ষক যোগ করতে এবং ইন্টারেক্টিভ বৈশিষ্ট্যগুলি পরীক্ষা করার বিষয়ে আরও জানতে, Google Chat অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্যগুলি পরীক্ষা করুন দেখুন।
সমস্যা সমাধান
যখন কোনও Google Chat অ্যাপ বা কার্ড কোনও ত্রুটি ফেরত দেয়, তখন Chat ইন্টারফেসটি "কিছু ভুল হয়েছে" বা "আপনার অনুরোধ প্রক্রিয়া করতে অক্ষম" বলে একটি বার্তা প্রকাশ করে। কখনও কখনও Chat UI কোনও ত্রুটির বার্তা প্রদর্শন করে না, তবে Chat অ্যাপ বা কার্ড একটি অপ্রত্যাশিত ফলাফল তৈরি করে; উদাহরণস্বরূপ, একটি কার্ড বার্তা প্রদর্শিত নাও হতে পারে।
যদিও চ্যাট UI তে কোনও ত্রুটির বার্তা প্রদর্শিত নাও হতে পারে, চ্যাট অ্যাপের জন্য ত্রুটি লগিং চালু থাকলে বর্ণনামূলক ত্রুটির বার্তা এবং লগ ডেটা আপনাকে ত্রুটিগুলি ঠিক করতে সাহায্য করার জন্য উপলব্ধ। ত্রুটিগুলি দেখা, ডিবাগ করা এবং ঠিক করার জন্য, Google Chat ত্রুটিগুলির সমস্যা সমাধান এবং সমাধান দেখুন।
পরিষ্কার করা
এই টিউটোরিয়ালে ব্যবহৃত রিসোর্সের জন্য আপনার Google ক্লাউড অ্যাকাউন্টে চার্জ এড়াতে, আমরা আপনাকে ক্লাউড প্রকল্পটি মুছে ফেলার পরামর্শ দিচ্ছি।
- গুগল ক্লাউড কনসোলে, রিসোর্স পরিচালনা পৃষ্ঠায় যান। মেনু > IAM & Admin > রিসোর্স পরিচালনা করুন এ ক্লিক করুন।
- প্রকল্পের তালিকায়, আপনি যে প্রকল্পটি মুছতে চান তা নির্বাচন করুন এবং তারপরে মুছুন ফেলুন ক্লিক করুন।
- ডায়ালগে, প্রজেক্ট আইডি টাইপ করুন এবং তারপর প্রজেক্টটি মুছে ফেলতে Shut down এ ক্লিক করুন।