5 মিনিট আছে? একটি দ্রুত অনলাইন সমীক্ষা করে আমাদের Google Workspace ডকুমেন্টেশন উন্নত করতে সাহায্য করুন। |
এই নির্দেশিকা ব্যাখ্যা করে যে Google Chat API-এর Message
রিসোর্সে create()
মেথড ব্যবহার করে নিচের যেকোনো একটি করতে হবে:
- পাঠ্য, কার্ড এবং ইন্টারেক্টিভ উইজেট ধারণ করে এমন বার্তা পাঠান।
- একটি নির্দিষ্ট চ্যাট ব্যবহারকারীকে ব্যক্তিগতভাবে বার্তা পাঠান।
- একটি বার্তা থ্রেড শুরু করুন বা উত্তর দিন।
- একটি বার্তার নাম দিন, যাতে আপনি অন্যান্য চ্যাট API অনুরোধগুলিতে এটি নির্দিষ্ট করতে পারেন৷
সর্বাধিক বার্তা আকার (যেকোন পাঠ্য বা কার্ড সহ) হল 32,000 বাইট। এই আকারের চেয়ে বেশি একটি বার্তা পাঠাতে, আপনার চ্যাট অ্যাপটিকে অবশ্যই একাধিক বার্তা পাঠাতে হবে।
বার্তা তৈরির জন্য চ্যাট এপিআই-কে কল করার পাশাপাশি, চ্যাট অ্যাপগুলি ব্যবহারকারীর ইন্টারঅ্যাকশনের উত্তর দেওয়ার জন্য বার্তা তৈরি করতে এবং পাঠাতে পারে, যেমন কোনও ব্যবহারকারী একটি স্পেসে চ্যাট অ্যাপ যোগ করার পরে একটি স্বাগত বার্তা পোস্ট করা। ইন্টারঅ্যাকশনে সাড়া দেওয়ার সময়, চ্যাট অ্যাপগুলি ইন্টারেক্টিভ ডায়ালগ এবং লিঙ্ক প্রিভিউ ইন্টারফেস সহ অন্যান্য ধরনের মেসেজিং বৈশিষ্ট্য ব্যবহার করতে পারে। একজন ব্যবহারকারীকে উত্তর দিতে, চ্যাট অ্যাপটি চ্যাট এপিআই কল না করেই বার্তাটি সিঙ্ক্রোনাসভাবে ফেরত দেয়। ইন্টারঅ্যাকশনের প্রতিক্রিয়া জানাতে বার্তা পাঠানো সম্পর্কে জানতে, আপনার Google চ্যাট অ্যাপের সাথে ইন্টারঅ্যাকশন গ্রহণ এবং প্রতিক্রিয়া দেখুন।
চ্যাট কীভাবে চ্যাট এপিআই-এর সাহায্যে তৈরি বার্তাগুলিকে প্রদর্শন করে এবং বৈশিষ্ট্যযুক্ত করে
আপনি অ্যাপ প্রমাণীকরণ এবং ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে create()
পদ্ধতিতে কল করতে পারেন। আপনি যে ধরনের প্রমাণীকরণ ব্যবহার করেন তার উপর নির্ভর করে চ্যাট বার্তা প্রেরককে আলাদাভাবে অ্যাট্রিবিউট করে।
আপনি যখন চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করেন, চ্যাট অ্যাপটি বার্তা পাঠায়।
App
প্রদর্শন করে।আপনি যখন একজন ব্যবহারকারী হিসাবে প্রমাণীকরণ করেন, তখন চ্যাট অ্যাপ ব্যবহারকারীর পক্ষে বার্তা পাঠায়। চ্যাট বার্তাটির নাম প্রদর্শন করে চ্যাট অ্যাপটিকেও দায়ী করে।
প্রমাণীকরণের ধরন এছাড়াও নির্ধারণ করে যে কোন বার্তাপ্রেরণ বৈশিষ্ট্য এবং ইন্টারফেসগুলি আপনি বার্তাটিতে অন্তর্ভুক্ত করতে পারেন। অ্যাপ প্রমাণীকরণের মাধ্যমে, চ্যাট অ্যাপগুলি এমন বার্তা পাঠাতে পারে যাতে সমৃদ্ধ পাঠ্য, কার্ড-ভিত্তিক ইন্টারফেস এবং ইন্টারেক্টিভ উইজেট থাকে। যেহেতু চ্যাট ব্যবহারকারীরা শুধুমাত্র তাদের বার্তাগুলিতে পাঠ্য পাঠাতে পারে, তাই আপনি ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে বার্তা তৈরি করার সময় শুধুমাত্র পাঠ্য অন্তর্ভুক্ত করতে পারেন। Chat API-এর জন্য উপলব্ধ মেসেজিং বৈশিষ্ট্যগুলি সম্পর্কে আরও জানতে, Google Chat বার্তাগুলির ওভারভিউ দেখুন।
এই নির্দেশিকাটি ব্যাখ্যা করে যে চ্যাট API এর সাথে একটি বার্তা পাঠাতে প্রমাণীকরণের ধরনটি কীভাবে ব্যবহার করতে হয়।
পূর্বশর্ত
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
- একটি Google চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী বা কলিং চ্যাট অ্যাপের সদস্য। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, স্পেসে চ্যাট অ্যাপ যোগ করুন ।
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
- একটি Google চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী বা কলিং চ্যাট অ্যাপের সদস্য। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, স্পেসে চ্যাট অ্যাপ যোগ করুন ।
জাভা
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
- একটি Google চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী বা কলিং চ্যাট অ্যাপের সদস্য। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, স্পেসে চ্যাট অ্যাপ যোগ করুন ।
অ্যাপস স্ক্রিপ্ট
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং উন্নত চ্যাট পরিষেবা চালু করুন।
- এই নির্দেশিকাতে, আপনাকে অবশ্যই ব্যবহারকারী বা অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন। ধাপগুলির জন্য, একটি Google চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ এবং অনুমোদন দেখুন।
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
- একটি Google চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী বা কলিং চ্যাট অ্যাপের সদস্য। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, স্পেসে চ্যাট অ্যাপ যোগ করুন ।
চ্যাট অ্যাপ হিসেবে একটি বার্তা পাঠান
অ্যাপ প্রমাণীকরণ ব্যবহার করে পাঠ্য, কার্ড এবং ইন্টারেক্টিভ আনুষঙ্গিক উইজেট ধারণ করে কীভাবে বার্তা পাঠাতে হয় এই বিভাগটি ব্যাখ্যা করে।
অ্যাপ প্রমাণীকরণ ব্যবহার করে CreateMessage()
পদ্ধতিতে কল করতে, আপনাকে অনুরোধে নিম্নলিখিত ক্ষেত্রগুলি নির্দিষ্ট করতে হবে:
-
chat.bot
অনুমোদনের সুযোগ । -
Space
রিসোর্স যেখানে আপনি বার্তা পোস্ট করতে চান। চ্যাট অ্যাপটিকে অবশ্যই স্পেসের সদস্য হতে হবে। - তৈরি করার জন্য
Message
সংস্থান। বার্তার বিষয়বস্তু সংজ্ঞায়িত করতে, আপনি সমৃদ্ধ পাঠ্য (text
), এক বা একাধিক কার্ড ইন্টারফেস (cardsV2
), বা উভয়ই অন্তর্ভুক্ত করতে পারেন।
ঐচ্ছিকভাবে, আপনি নিম্নলিখিত অন্তর্ভুক্ত করতে পারেন:
- বার্তার নীচে ইন্টারেক্টিভ বোতামগুলি অন্তর্ভুক্ত করার জন্য
accessoryWidgets
ক্ষেত্র। - একটি নির্দিষ্ট ব্যবহারকারীকে ব্যক্তিগতভাবে বার্তা পাঠানোর জন্য
privateMessageViewer
ক্ষেত্র। -
messageId
ক্ষেত্র, যা আপনাকে অন্যান্য API অনুরোধে ব্যবহার করার জন্য বার্তাটির নাম দিতে দেয়। - একটি থ্রেড শুরু বা উত্তর দিতে
thread.threadKey
এবংmessageReplyOption
ক্ষেত্র। স্থানটি থ্রেডিং ব্যবহার না করলে, এই ক্ষেত্রটি উপেক্ষা করা হয়।
নিম্নলিখিত কোডটি একটি উদাহরণ দেখায় যে কীভাবে একটি চ্যাট অ্যাপ চ্যাট অ্যাপ হিসাবে পোস্ট করা একটি বার্তা পাঠাতে পারে যাতে বার্তার নীচে পাঠ্য, একটি কার্ড এবং একটি ক্লিকযোগ্য বোতাম রয়েছে:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনাটি চালানোর জন্য, স্পেসের name
ক্ষেত্র থেকে আইডি দিয়ে SPACE_NAME
প্রতিস্থাপন করুন। আপনি ListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
একটি বার্তার নীচে ইন্টারেক্টিভ উইজেট যোগ করুন
এই গাইডের প্রথম কোড নমুনায়, চ্যাট অ্যাপ বার্তাটি বার্তার নীচে একটি ক্লিকযোগ্য বোতাম প্রদর্শন করে, যা একটি আনুষঙ্গিক উইজেট নামে পরিচিত। আনুষঙ্গিক উইজেটগুলি কোনও বার্তায় কোনও পাঠ্য বা কার্ডের পরে উপস্থিত হয়। আপনি এই উইজেটগুলি ব্যবহার করে ব্যবহারকারীদের আপনার বার্তার সাথে বিভিন্ন উপায়ে ইন্টারঅ্যাক্ট করতে অনুরোধ করতে পারেন, নিম্নলিখিতগুলি সহ:
- একটি বার্তার নির্ভুলতা বা সন্তুষ্টি রেট করুন।
- বার্তা বা চ্যাট অ্যাপের সাথে একটি সমস্যা রিপোর্ট করুন।
- সম্পর্কিত বিষয়বস্তুর একটি লিঙ্ক খুলুন, যেমন ডকুমেন্টেশন।
- নির্দিষ্ট সময়ের জন্য চ্যাট অ্যাপ থেকে একই ধরনের মেসেজ খারিজ বা স্নুজ করুন।
আনুষঙ্গিক উইজেটগুলি যোগ করতে, আপনার অনুরোধের মূল অংশে accessoryWidgets[]
ক্ষেত্রটি অন্তর্ভুক্ত করুন এবং আপনি যে এক বা একাধিক উইজেট অন্তর্ভুক্ত করতে চান তা নির্দিষ্ট করুন৷
নিম্নলিখিত চিত্রটি একটি চ্যাট অ্যাপ দেখায় যা আনুষঙ্গিক উইজেটগুলির সাথে একটি পাঠ্য বার্তা যুক্ত করে যাতে ব্যবহারকারীরা চ্যাট অ্যাপের সাথে তাদের অভিজ্ঞতাকে রেট দিতে পারে।

নিম্নলিখিতটি অনুরোধের মূল অংশটি দেখায় যা দুটি আনুষঙ্গিক বোতাম সহ একটি পাঠ্য বার্তা তৈরি করে। যখন একজন ব্যবহারকারী একটি বোতামে ক্লিক করেন, তখন সংশ্লিষ্ট ফাংশন (যেমন doUpvote
) মিথস্ক্রিয়া প্রক্রিয়া করে:
{
text: "Rate your experience with this Chat app.",
accessoryWidgets: [{ buttonList: { buttons: [{
icon: { material_icon: {
name: "thumb_up"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doUpvote"
}}
}, {
icon: { material_icon: {
name: "thumb_down"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doDownvote"
}}
}]}}]
}
ব্যক্তিগতভাবে একটি বার্তা পাঠান
চ্যাট অ্যাপগুলি ব্যক্তিগতভাবে বার্তা পাঠাতে পারে যাতে বার্তাটি শুধুমাত্র স্থানের একটি নির্দিষ্ট ব্যবহারকারীর কাছে দৃশ্যমান হয়। যখন একটি চ্যাট অ্যাপ একটি ব্যক্তিগত বার্তা পাঠায়, বার্তাটি একটি লেবেল দেখায় যা ব্যবহারকারীকে সূচিত করে যে বার্তাটি শুধুমাত্র তাদের কাছে দৃশ্যমান।
চ্যাট API ব্যবহার করে ব্যক্তিগতভাবে একটি বার্তা পাঠাতে, আপনার অনুরোধের মূল অংশে privateMessageViewer
ক্ষেত্রটি নির্দিষ্ট করুন। ব্যবহারকারীকে নির্দিষ্ট করতে, আপনি User
সম্পদের মান সেট করেন যা চ্যাট ব্যবহারকারীর প্রতিনিধিত্ব করে। আপনি User
সম্পদের name
ক্ষেত্রটিও ব্যবহার করতে পারেন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
{
text: "Hello private world!",
privateMessageViewer: {
name: "users/USER_ID"
}
}
এই নমুনাটি ব্যবহার করতে, ব্যবহারকারীর জন্য একটি অনন্য ID দিয়ে USER_ID
প্রতিস্থাপন করুন, যেমন 12345678987654321
বা hao@cymbalgroup.com
। ব্যবহারকারীদের নির্দিষ্ট করার বিষয়ে আরও তথ্যের জন্য, Google Chat ব্যবহারকারীদের সনাক্ত করুন এবং নির্দিষ্ট করুন দেখুন।
ব্যক্তিগতভাবে একটি বার্তা পাঠাতে, আপনাকে আপনার অনুরোধে নিম্নলিখিতগুলি বাদ দিতে হবে:
একজন ব্যবহারকারীর পক্ষে একটি পাঠ্য বার্তা পাঠান
এই বিভাগটি ব্যাখ্যা করে কিভাবে ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে ব্যবহারকারীর পক্ষে বার্তা পাঠাতে হয়। ব্যবহারকারীর প্রমাণীকরণের মাধ্যমে, মেসেজের বিষয়বস্তুতে শুধুমাত্র টেক্সট থাকতে পারে এবং কার্ড ইন্টারফেস এবং ইন্টারেক্টিভ উইজেট সহ শুধুমাত্র চ্যাট অ্যাপে উপলব্ধ মেসেজিং বৈশিষ্ট্যগুলিকে বাদ দিতে হবে।
ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে CreateMessage()
পদ্ধতিতে কল করতে, আপনাকে অনুরোধে নিম্নলিখিত ক্ষেত্রগুলি নির্দিষ্ট করতে হবে:
- একটি অনুমোদনের সুযোগ যা এই পদ্ধতির জন্য ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে। নিম্নলিখিত নমুনা
chat.messages.create
সুযোগ ব্যবহার করে। -
Space
রিসোর্স যেখানে আপনি বার্তা পোস্ট করতে চান। প্রমাণীকৃত ব্যবহারকারীকে অবশ্যই স্থানের সদস্য হতে হবে। - তৈরি করার জন্য
Message
সংস্থান। বার্তার বিষয়বস্তু নির্ধারণ করতে, আপনাকে অবশ্যইtext
ক্ষেত্র অন্তর্ভুক্ত করতে হবে।
ঐচ্ছিকভাবে, আপনি নিম্নলিখিত অন্তর্ভুক্ত করতে পারেন:
-
messageId
ক্ষেত্র, যা আপনাকে অন্যান্য API অনুরোধে ব্যবহার করার জন্য বার্তাটির নাম দিতে দেয়। - একটি থ্রেড শুরু বা উত্তর দিতে
thread.threadKey
এবংmessageReplyOption
ক্ষেত্র। স্থানটি থ্রেডিং ব্যবহার না করলে, এই ক্ষেত্রটি উপেক্ষা করা হয়।
নিম্নলিখিত কোডটি একটি প্রমাণীকৃত ব্যবহারকারীর পক্ষে একটি প্রদত্ত স্থানে একটি চ্যাট অ্যাপ কীভাবে একটি পাঠ্য বার্তা পাঠাতে পারে তার একটি উদাহরণ দেখায়:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনাটি চালানোর জন্য, স্পেসের name
ক্ষেত্র থেকে আইডি দিয়ে SPACE_NAME
প্রতিস্থাপন করুন। আপনি ListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
শুরু বা একটি থ্রেড উত্তর
থ্রেডগুলি ব্যবহার করে এমন স্থানগুলির জন্য, আপনি নির্দিষ্ট করতে পারেন যে একটি নতুন বার্তা একটি থ্রেড শুরু করে, বা একটি বিদ্যমান থ্রেডের উত্তর দেয়।
ডিফল্টরূপে, Chat API ব্যবহার করে আপনি যে বার্তাগুলি তৈরি করেন সেগুলি একটি নতুন থ্রেড শুরু করে৷ থ্রেডটি সনাক্ত করতে এবং পরে এটির উত্তর দিতে আপনাকে সাহায্য করার জন্য, আপনি আপনার অনুরোধে একটি থ্রেড কী নির্দিষ্ট করতে পারেন:
- আপনার অনুরোধের মূল অংশে,
thread.threadKey
ক্ষেত্রটি নির্দিষ্ট করুন। - কীটি ইতিমধ্যেই বিদ্যমান থাকলে কী হবে তা নির্ধারণ করতে ক্যোয়ারী প্যারামিটার
messageReplyOption
নির্দিষ্ট করুন।
একটি বিদ্যমান থ্রেডের উত্তর দেয় এমন একটি বার্তা তৈরি করতে:
- আপনার অনুরোধের মূল অংশে,
thread
ক্ষেত্রটি অন্তর্ভুক্ত করুন। সেট করা থাকলে, আপনি যেthreadKey
তৈরি করেছেন তা নির্দিষ্ট করতে পারেন। অন্যথায়, আপনাকে অবশ্যই থ্রেডেরname
ব্যবহার করতে হবে। - ক্যোয়ারী প্যারামিটার
messageReplyOption
নির্দিষ্ট করুন।
নিম্নলিখিত কোডটি একটি উদাহরণ দেখায় যে কীভাবে একটি চ্যাট অ্যাপ একটি টেক্সট বার্তা পাঠাতে পারে যা একটি প্রদত্ত থ্রেডে শুরু হয় বা প্রত্যুত্তর দেয় যেটি একটি প্রদত্ত স্থানের কী দ্বারা চিহ্নিত করা হয়েছে:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
THREAD_KEY
: স্পেসে বিদ্যমান একটি থ্রেড কী, অথবা একটি নতুন থ্রেড তৈরি করতে, থ্রেডের জন্য একটি অনন্য নাম। -
SPACE_NAME
: স্পেসেরname
ক্ষেত্র থেকে আইডি। আপনিListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
একটি বার্তার নাম দিন
ভবিষ্যতের API কলগুলিতে একটি বার্তা পুনরুদ্ধার বা নির্দিষ্ট করতে, আপনি আপনার অনুরোধে messageId
ক্ষেত্র সেট করে একটি বার্তার নাম দিতে পারেন। আপনার বার্তার নামকরণ আপনাকে বার্তাটির সংস্থান নাম থেকে ( name
ক্ষেত্রে উপস্থাপিত) সিস্টেম দ্বারা নির্ধারিত আইডি সংরক্ষণ করার প্রয়োজন ছাড়াই বার্তাটি নির্দিষ্ট করতে দেয়।
উদাহরণস্বরূপ, get()
পদ্ধতি ব্যবহার করে একটি বার্তা পুনরুদ্ধার করতে, আপনি কোন বার্তাটি পুনরুদ্ধার করতে হবে তা নির্দিষ্ট করতে রিসোর্স নাম ব্যবহার করেন। রিসোর্সের নামটি spaces/{space}/messages/{message}
হিসাবে ফর্ম্যাট করা হয়েছে, যেখানে {message}
সিস্টেম-অর্পণ করা আইডি বা আপনি বার্তা তৈরি করার সময় যে কাস্টম নাম সেট করেছেন তা উপস্থাপন করে।
একটি বার্তার নাম দেওয়ার জন্য, আপনি যখন বার্তা তৈরি করবেন তখন messageId
ক্ষেত্রে একটি কাস্টম আইডি উল্লেখ করুন। messageId
ক্ষেত্রটি Message
সংস্থানের clientAssignedMessageId
ক্ষেত্রের মান সেট করে।
আপনি যখন বার্তা তৈরি করবেন তখনই আপনি একটি বার্তার নাম দিতে পারেন৷ আপনি বিদ্যমান বার্তাগুলির জন্য একটি কাস্টম আইডি নাম বা পরিবর্তন করতে পারবেন না৷ কাস্টম আইডি নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে:
-
client-
দিয়ে শুরু হয়-। উদাহরণস্বরূপ,client-custom-name
একটি বৈধ কাস্টম আইডি, কিন্তুcustom-name
নয়। - 63টি পর্যন্ত অক্ষর এবং শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন রয়েছে৷
- একটি স্থান মধ্যে অনন্য. একটি চ্যাট অ্যাপ বিভিন্ন বার্তার জন্য একই কাস্টম আইডি ব্যবহার করতে পারে না।
নিম্নলিখিত কোডটি একটি প্রমাণীকৃত ব্যবহারকারীর পক্ষে একটি প্রদত্ত স্পেসে একটি আইডি সহ একটি টেক্সট বার্তা পাঠাতে পারে তার একটি উদাহরণ দেখায়:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
এই নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
SPACE_NAME
: স্পেসেরname
ক্ষেত্র থেকে আইডি। আপনিListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন। -
MESSAGE-ID
:custom-
দিয়ে শুরু হওয়া বার্তার একটি নাম। নির্দিষ্ট জায়গায় চ্যাট অ্যাপের তৈরি অন্য যেকোন মেসেজ নামের থেকে অনন্য হতে হবে।
একটি বার্তা উদ্ধৃত করুন
আপনি CreateMessage()
( rpc
, rest
) কল করে এবং অনুরোধে quotedMessageMetadata
( rpc
, rest
) সেট করে অন্য একটি বার্তা উদ্ধৃত করতে পারেন৷
আপনি একটি থ্রেডের মধ্যে বা প্রধান চ্যাটে বার্তা উদ্ধৃত করতে পারেন, কিন্তু আপনি একটি ভিন্ন থ্রেড থেকে একটি বার্তা উদ্ধৃত করতে পারবেন না।
নিম্নলিখিত কোডটি দেখায় কিভাবে একটি বার্তা তৈরি করতে হয় যা অন্য বার্তাকে উদ্ধৃত করে:
Node.js
import {createClientWithUserCredentials} from './authentication-utils.js';
const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.messages.create'];
// This sample shows how to create a message that quotes another message.
async function main() {
// Create a client
const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);
// Initialize request argument(s)
const request = {
// TODO(developer): Replace SPACE_NAME .
parent: 'spaces/SPACE_NAME',
message: {
text: 'I am responding to a quoted message!',
// quotedMessageMetadata lets chat apps respond to a message by quoting it.
quotedMessageMetadata: {
// TODO(developer): Replace QUOTED_MESSAGE_NAME
// and QUOTED_MESSAGE_LAST_UPDATE_TIME.
name: 'QUOTED_MESSAGE_NAME',
lastUpdateTime: 'QUOTED_MESSAGE_LAST_UPDATE_TIME'
}
}
};
// Make the request
const response = await chatClient.createMessage(request);
// Handle the response
console.log(response);
}
main().catch(console.error);
পাইথন
from authentication_utils import create_client_with_user_credentials
from google.apps import chat_v1 as google_chat
from google.protobuf.timestamp_pb2 import Timestamp
SCOPES = ['https://www.googleapis.com/auth/chat.messages.create']
# This sample shows how to create a message that quotes another message.
def create_message_quote_message():
'''Creates a message that quotes another message.'''
# Create a client
client = create_client_with_user_credentials(SCOPES)
# Create a timestamp from the RFC-3339 string.
# TODO(developer): Replace QUOTED_MESSAGE_LAST_UPDATE_TIME.
last_update_time = Timestamp()
last_update_time.FromJsonString('QUOTED_MESSAGE_LAST_UPDATE_TIME')
# Initialize request argument(s)
request = google_chat.CreateMessageRequest(
# TODO(developer): Replace SPACE_NAME.
parent='spaces/SPACE_NAME',
# Create the message.
message = google_chat.Message(
text='I am responding to a quoted message!',
# quotedMessageMetadata lets chat apps respond to a message by quoting it.
quoted_message_metadata=google_chat.QuotedMessageMetadata(
name='QUOTED_MESSAGE_NAME',
last_update_time=last_update_time
)
)
)
# Make the request
response = client.create_message(request)
# Handle the response
print(response)
create_message_quote_message()
জাভা
import com.google.chat.v1.ChatServiceClient;
import com.google.chat.v1.CreateMessageRequest;
import com.google.chat.v1.Message;
import com.google.chat.v1.QuotedMessageMetadata;
import com.google.protobuf.util.Timestamps;
import com.google.workspace.api.chat.samples.utils.AuthenticationUtils;
import java.text.ParseException;
// This sample shows how to create a message that quotes another message.
public class CreateMessageQuoteMessage {
public static void main(String[] args) throws Exception, ParseException {
// Create a client.
ChatServiceClient chatClient = AuthenticationUtils.createClientWithUserCredentials();
// Initialize request argument(s).
// TODO(developer): Replace SPACE_NAME, QUOTED_MESSAGE_NAME,
// and QUOTED_MESSAGE_LAST_UPDATE_TIME here.
String parent = "spaces/SPACE_NAME";
String quotedMessageName = "QUOTED_MESSAGE_NAME";
String lastUpdateTime = "QUOTED_MESSAGE_LAST_UPDATE_TIME";
QuotedMessageMetadata quotedMessageMetadata =
QuotedMessageMetadata.newBuilder()
.setName(quotedMessageName)
.setLastUpdateTime(Timestamps.parse(lastUpdateTime))
.build();
Message message = Message.newBuilder()
.setText("I am responding to a quoted message!")
.setQuotedMessageMetadata(quotedMessageMetadata)
.build();
CreateMessageRequest request =
CreateMessageRequest.newBuilder()
.setParent(parent)
.setMessage(message)
.build();
// Make the request.
Message response = chatClient.createMessage(request);
// Handle the response.
System.out.println(response);
}
}
অ্যাপস স্ক্রিপ্ট
/**
* Creates a message that quotes another message.
*
* Relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.messages.create'
* referenced in the manifest file (appsscript.json).
*/
function createMessageQuoteMessage() {
// Initialize request argument(s)
// TODO(developer): Replace SPACE_NAME here.
const parent = 'spaces/SPACE_NAME';
const message = {
// The text content of the message.
text: 'I am responding to a quoted message!',
// quotedMessageMetadata lets chat apps respond to a message by quoting it.
//
// TODO(developer): Replace QUOTED_MESSAGE_NAME
// and QUOTED_MESSAGE_LAST_UPDATE_TIME .
quotedMessageMetadata: {
name: 'QUOTED_MESSAGE_NAME',
lastUpdateTime: 'QUOTED_MESSAGE_LAST_UPDATE_TIME',
}
};
// Make the request
const response = Chat.Spaces.Messages.create(message, parent);
// Handle the response
console.log(response);
}
এই নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
SPACE_NAME
: স্পেসেরname
ক্ষেত্র থেকে আইডি। আপনিListSpaces()
(rpc
,rest
) পদ্ধতিতে কল করে অথবা স্পেস এর URL থেকে আইডি পেতে পারেন। -
QUOTED_MESSAGE_NAME
: বার্তাটির রিসোর্সname
(rpc
,rest
)spaces/{space}/messages/{message}
ফর্ম্যাটে উদ্ধৃত করতে। -
QUOTED_MESSAGE_LAST_UPDATE_TIME
: আপনি যে বার্তাটি উদ্ধৃত করতে চান তার শেষ আপডেটের সময়৷ যদি বার্তাটি কখনও সম্পাদনা করা না হয়, তাহলেcreateTime
(rpc
,rest
) এর সাথে মিলে যায়। বার্তাটি সম্পাদিত হলে,lastUpdateTime
(rpc
,rest
) এর সাথে মিলে যায়।
সমস্যা সমাধান
যখন একটি Google চ্যাট অ্যাপ বা কার্ড একটি ত্রুটি ফেরত দেয়, তখন চ্যাট ইন্টারফেস "কিছু ভুল হয়েছে" বলে একটি বার্তা দেখায়। অথবা "আপনার অনুরোধ প্রক্রিয়া করতে অক্ষম।" কখনও কখনও চ্যাট UI কোনও ত্রুটি বার্তা প্রদর্শন করে না, তবে চ্যাট অ্যাপ বা কার্ড একটি অপ্রত্যাশিত ফলাফল তৈরি করে; উদাহরণস্বরূপ, একটি কার্ড বার্তা প্রদর্শিত নাও হতে পারে৷
যদিও একটি ত্রুটি বার্তা চ্যাট UI-তে প্রদর্শিত নাও হতে পারে, বর্ণনামূলক ত্রুটি বার্তা এবং লগ ডেটা উপলব্ধ রয়েছে যাতে আপনি যখন চ্যাট অ্যাপগুলির জন্য ত্রুটি লগিং চালু থাকে তখন ত্রুটিগুলি ঠিক করতে সহায়তা করে৷ দেখা, ডিবাগিং এবং ত্রুটিগুলি সংশোধন করতে সহায়তার জন্য, Google Chat ত্রুটিগুলি সমস্যা সমাধান এবং ঠিক করুন দেখুন৷
সম্পর্কিত বিষয়
- চ্যাট অ্যাপের জন্য JSON কার্ড মেসেজ ডিজাইন ও প্রিভিউ করতে কার্ড বিল্ডার ব্যবহার করুন ।
- বার্তা ফরম্যাট করুন ।
- একটি বার্তা সম্পর্কে বিস্তারিত পান ।
- একটি স্পেসে বার্তা তালিকাভুক্ত করুন ।
- একটি বার্তা আপডেট করুন ।
- একটি বার্তা মুছুন ।
- Google চ্যাট মেসেজে ব্যবহারকারীদের শনাক্ত করুন ।
- ইনকামিং ওয়েবহুক দিয়ে Google চ্যাটে বার্তা পাঠান ।