এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে একটি স্পেসের মধ্যে থাকা টেক্সট বা কার্ড মেসেজ আপডেট করার জন্য Google Chat API-এর Message রিসোর্সের update মেথডটি ব্যবহার করতে হয়। মেসেজের অ্যাট্রিবিউট, যেমন মেসেজের লেখা বা কার্ডের বিষয়বস্তু পরিবর্তন করতে একটি মেসেজ আপডেট করুন। এছাড়াও আপনি একটি কার্ড মেসেজের শুরুতে একটি টেক্সট মেসেজ যোগ করতে পারেন, অথবা একটি টেক্সট মেসেজের শেষে একটি কার্ড যুক্ত করতে পারেন।
চ্যাট এপিআই-তে, একটি চ্যাট মেসেজকে Message রিসোর্স দ্বারা উপস্থাপন করা হয়। যদিও চ্যাট ব্যবহারকারীরা শুধুমাত্র টেক্সট-ভিত্তিক মেসেজ পাঠাতে পারেন, চ্যাট অ্যাপগুলো আরও অনেক মেসেজিং ফিচার ব্যবহার করতে পারে, যার মধ্যে রয়েছে স্ট্যাটিক বা ইন্টারেক্টিভ ইউজার ইন্টারফেস প্রদর্শন করা, ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ করা এবং ব্যক্তিগতভাবে মেসেজ পাঠানো। চ্যাট এপিআই-এর জন্য উপলব্ধ মেসেজিং ফিচারগুলো সম্পর্কে আরও জানতে, গুগল চ্যাট মেসেজ ওভারভিউ দেখুন।
পূর্বশর্ত
নোড.জেএস
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - To authenticate as the Chat app, create service account credentials and save the credentials as a JSON file named
credentials.json.
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
পাইথন
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
জাভা
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি করুন এবং অ্যাডভান্সড চ্যাট সার্ভিসটি চালু করুন।
- এই নির্দেশিকায়, আপনাকে অবশ্যই ব্যবহারকারী অথবা অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন। ধাপগুলোর জন্য, ‘গুগল চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ ও অনুমোদন’ দেখুন।
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
একজন ব্যবহারকারীর পক্ষ থেকে একটি বার্তা আপডেট করুন
ব্যবহারকারী প্রমাণীকরণের মাধ্যমে শুধুমাত্র বার্তার লেখা আপডেট করা যায়।
ব্যবহারকারীর প্রমাণীকরণের মাধ্যমে কোনো বার্তা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো প্রদান করুন:
-
chat.messagesএর অনুমোদনের পরিধি নির্দিষ্ট করুন। -
UpdateMessageমেথডটি কল করুন। - নিম্নলিখিতভাবে
Messageএর একটি ইনস্ট্যান্স হিসেবেmessageপাঠান:- আপডেট করার জন্য মেসেজটির
nameফিল্ড সেট করা হয়, যার মধ্যে একটি স্পেস আইডি এবং একটি মেসেজ আইডি অন্তর্ভুক্ত থাকে। -
textফিল্ডটি নতুন টেক্সট দিয়ে সেট করা হয়েছে।
- আপডেট করার জন্য মেসেজটির
-
textভ্যালুটি দিয়েupdateMaskপাস করুন।
আপডেট করা বার্তাটি যদি একটি কার্ড বার্তা হয়, তাহলে লেখাটি কার্ডগুলোর শুরুতে যুক্ত হয় (এবং কার্ডগুলো প্রদর্শিত হতে থাকে)।
ব্যবহারকারীর প্রমাণীকরণের মাধ্যমে কীভাবে একটি বার্তা আপডেট করবেন, অথবা কার্ড বার্তার শুরুতে একটি টেক্সট বার্তা যুক্ত করবেন, তা এখানে দেওয়া হলো:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসটিরnameথেকে প্রাপ্ত আইডি। আপনিListSpacesমেথড কল করে অথবা স্পেসটির URL থেকে আইডিটি পেতে পারেন। -
MESSAGE_NAME: বার্তারnameথেকে প্রাপ্ত আইডি। আপনি চ্যাট এপিআই (Chat API) ব্যবহার করে অ্যাসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে ফেরত আসা রেসপন্স বডি থেকে, অথবা বার্তা তৈরির সময় নির্ধারিত কাস্টম নাম থেকে এই আইডিটি পেতে পারেন।
চ্যাট এপিআই Message এর একটি ইনস্ট্যান্স রিটার্ন করে, যা আপডেট করা মেসেজটির বিবরণ দেয়।
চ্যাট অ্যাপ হিসেবে একটি বার্তা আপডেট করুন
অ্যাপ অথেনটিকেশনের মাধ্যমে একটি মেসেজের টেক্সট এবং কার্ড উভয়ই আপডেট করা যায়।
অ্যাপ প্রমাণীকরণের মাধ্যমে কোনো বার্তা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো দিন:
-
chat.botঅনুমোদনের পরিধি নির্দিষ্ট করুন। -
UpdateMessageমেথডটি কল করুন। - নিম্নলিখিতভাবে
Messageএর একটি ইনস্ট্যান্স হিসেবেmessageপাঠান:- আপডেট করার জন্য মেসেজটির
nameফিল্ড সেট করা হয়, যার মধ্যে একটি স্পেস আইডি এবং একটি মেসেজ আইডি অন্তর্ভুক্ত থাকে। - আপডেট করার প্রয়োজন হলে
textফিল্ডটিতে নতুন টেক্সট সেট করা হবে। - প্রয়োজন হলে
cardsV2ফিল্ডটি নতুন কার্ডগুলো দিয়ে সেট করা হবে।
- আপডেট করার জন্য মেসেজটির
- আপডেট করার জন্য ফিল্ডের তালিকা, যেমন
textএবংcardsV2, সহupdateMaskপাস করুন।
যদি আপডেট করা বার্তাটি একটি কার্ড বার্তা হয় এবং টেক্সট আপডেট করা হয়, তাহলে আপডেট করা টেক্সটটি কার্ডগুলোর শুরুতে যুক্ত হয় (যেগুলো প্রদর্শিত হতে থাকে)। যদি আপডেট করা বার্তাটি একটি টেক্সট বার্তা হয় এবং কার্ডগুলো আপডেট করা হয়, তাহলে আপডেট করা কার্ডগুলো টেক্সটের শেষে যুক্ত হয় (যেটি প্রদর্শিত হতে থাকে)।
অ্যাপ অথেন্টিকেশন ব্যবহার করে একটি মেসেজের টেক্সট ও কার্ড আপডেট করার পদ্ধতি নিচে দেওয়া হলো:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসটিরnameথেকে প্রাপ্ত আইডি। আপনিListSpacesমেথড কল করে অথবা স্পেসটির URL থেকে আইডিটি পেতে পারেন। -
MESSAGE_NAME: বার্তারnameথেকে প্রাপ্ত আইডি। আপনি চ্যাট এপিআই (Chat API) ব্যবহার করে অ্যাসিঙ্ক্রোনাসভাবে একটি বার্তা তৈরি করার পরে ফেরত আসা রেসপন্স বডি থেকে, অথবা বার্তা তৈরির সময় নির্ধারিত কাস্টম নাম থেকে এই আইডিটি পেতে পারেন।
চ্যাট এপিআই Message এর একটি ইনস্ট্যান্স রিটার্ন করে, যা আপডেট করা মেসেজটির বিবরণ দেয়।
অ্যাসিঙ্ক্রোনাসভাবে কার্ডগুলি আপডেট করুন
ডেভেলপার প্রিভিউতে , আপনি ` replaceCards মেথড ব্যবহার করে একটি মেসেজের কার্ডগুলো অ্যাসিঙ্ক্রোনাসভাবে আপডেট করতে পারেন। ব্যবহারকারীর হস্তক্ষেপ ছাড়াই কোনো কার্ডের বিষয়বস্তু আপডেট করার জন্য এটি উপযোগী, যেমন—লিঙ্ক প্রিভিউ রিফ্রেশ করা বা কোনো টাস্কের স্ট্যাটাস আপডেট করা। এই মেথডটি অ্যাপ দ্বারা তৈরি করা মেসেজগুলোর জন্য কাজ করে, যার মধ্যে ব্যবহারকারীর পক্ষ থেকে তৈরি করা মেসেজও অন্তর্ভুক্ত।
বিস্তারিত জানতে, কার্ড তৈরি ও আপডেট করুন দেখুন।
সম্পর্কিত বিষয়
- একটি বার্তা বিন্যাস করুন ।
- একটি বার্তা মুছে ফেলুন ।
- একটি বার্তা সম্পর্কে বিস্তারিত জানুন ।
- একটি স্পেসে বার্তাগুলির তালিকা তৈরি করুন ।
- একটি বার্তা পাঠান ।