টুল: list_messages
Markdown ফর্ম্যাটে নির্দিষ্ট Google Chat কথোপকথন (স্পেস, সরাসরি মেসেজ (DM) বা গ্রুপ DM) থেকে মেসেজ ফিরিয়ে আনে। থ্রেড, সময়সীমা ও মেসেজের সংখ্যা অনুযায়ী ফিল্টার করার অনুমতি দেয়। এছাড়াও, আরও প্রসঙ্গ দেখানোর জন্য মেসেজের পরবর্তী পৃষ্ঠা ফিরিয়ে আনা হতে পারে। ব্যক্তিগত মেসেজ (যে মেসেজ শুধুমাত্র একজন ব্যবহারকারী দেখতে পান) ফিল্টার করে বাদ দেওয়া হয়।
list_messages MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয় তা নিম্নলিখিত কোড স্যাম্পেল থেকে জানতে পারবেন।
| Curl অনুরোধ |
|---|
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_messages", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
ইনপুট স্কিমা
ListChatMessagesRequest
| JSON উপস্থাপনা |
|---|
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string } |
| ফিল্ড | |
|---|---|
conversationId |
প্রয়োজনীয়। কথোপকথনের আইডি। কথোপকথন বলতে স্পেস, সরাসরি মেসেজ (DM) বা গ্রুপ DM/চ্যাট বোঝায়। ফর্ম্যাট: spaces/{space} |
threadId |
ঐচ্ছিক। কথোপকথনের মধ্যে নির্দিষ্ট থ্রেডের আইডি। প্রদান করা হলে, শুধুমাত্র এই থ্রেড থেকে মেসেজ ফেরত দেওয়া হবে। বাদ দেওয়া হলে, কথোপকথনের সব থ্রেডের মেসেজ বিবেচনা করা হয়। ফর্ম্যাট: spaces/{space}/threads/{thread} |
pageSize |
ঐচ্ছিক। ফেরত পাঠানোর জন্য সর্বাধিক সংখ্যক মেসেজ। পরিষেবাটি এই মানের চেয়ে কম রিটার্ন করতে পারে। নির্দিষ্ট করা না থাকলে, ডিফল্ট হল ২০। সর্বাধিক ভ্যালু হল ৫০। আপনি ৫০-এর বেশি ভ্যালু ব্যবহার করলে, এটি অটোমেটিক ৫০-এ পরিবর্তন হয়ে যায়। |
pageToken |
ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, যা আগের list_messages কল থেকে পাওয়া গেছে। পরবর্তী পৃষ্ঠাটি ফিরিয়ে আনতে এটি প্রদান করুন। |
startTime |
ঐচ্ছিক। মেসেজ ফিল্টার করার জন্য ISO 8601 টাইমস্ট্যাম্প। শুধুমাত্র এই সময়ের পরে তৈরি করা মেসেজ ফেরত দেওয়া হবে। |
endTime |
ঐচ্ছিক। মেসেজ ফিল্টার করার জন্য ISO 8601 টাইমস্ট্যাম্প। শুধুমাত্র এই সময়ের আগে তৈরি করা মেসেজ ফেরত দেওয়া হবে। |
আউটপুট স্কিমা
অনুরোধ করা কথোপকথন থেকে মেসেজের তালিকা সহ উত্তর।
ListChatMessagesResponse
| JSON উপস্থাপনা |
|---|
{
"messages": [
{
object ( |
| ফিল্ড | |
|---|---|
messages[] |
মেসেজের তালিকা বিপরীত কালানুক্রমিক ক্রমে (সবচেয়ে নতুন মেসেজ প্রথমে) ফিরিয়ে আনা হয়েছে। |
nextPageToken |
একটি টোকেন, যা পরবর্তী পৃষ্ঠার মেসেজ ফিরিয়ে আনতে পরবর্তী |
ChatMessage
| JSON উপস্থাপনা |
|---|
{ "messageId": string, "threadId": string, "plaintextBody": string, "sender": { object ( |
| ফিল্ড | |
|---|---|
messageId |
মেসেজের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message} |
threadId |
এই মেসেজটি যে থ্রেডের অন্তর্গত। মেসেজটি থ্রেড করা না থাকলে এটি খালি থাকবে। ফর্ম্যাট: spaces/{space}/threads/{thread} |
plaintextBody |
মার্কডাউন ফর্ম্যাটিং ব্যবহার করে মেসেজের টেক্সট বডি। |
sender |
মেসেজের প্রেরক। |
createTime |
শুধু আউটপুট। মেসেজটি কখন তৈরি করা হয়েছিল সেই টাইমস্ট্যাম্প। ফর্ম্যাট: ISO 8601 টাইমস্ট্যাম্প। |
threadedReply |
মেসেজটি থ্রেডের উত্তর কিনা। |
attachments[] |
মেসেজে অ্যাটাচমেন্ট যোগ করা হয়েছে। |
reactionSummaries[] |
মেসেজে ইমোজি প্রতিক্রিয়ার সারসংক্ষেপ অন্তর্ভুক্ত করা হয়েছে। |
quotedMessageMetadata |
শুধু আউটপুট। এই মেসেজে উদ্ধৃত বা ফরওয়ার্ড করা আসল মেসেজ সম্পর্কে তথ্য। মনে রাখবেন: এই ফিল্ডটি এখনও ডেভেলপ করা হচ্ছে এবং সব পরিবেশে এখনও উপলভ্য নাও হতে পারে। |
ব্যবহারকারী
| JSON উপস্থাপনা |
|---|
{
"userId": string,
"displayName": string,
"email": string,
"userType": enum ( |
| ফিল্ড | |
|---|---|
userId |
Chat ব্যবহারকারীর রিসোর্স নাম। ফর্ম্যাট: users/{user}। |
displayName |
Chat ব্যবহারকারীর ডিসপ্লে নাম। |
email |
ব্যবহারকারীর ইমেল আইডি। ব্যবহারকারীর ধরন HUMAN হলে তবেই এই ফিল্ডে তথ্য দেখানো হয়। |
userType |
ব্যবহারকারীর ধরন। |
ChatAttachmentMetadata
| JSON উপস্থাপনা |
|---|
{
"attachmentId": string,
"filename": string,
"mimeType": string,
"source": enum ( |
| ফিল্ড | |
|---|---|
attachmentId |
অ্যাটাচমেন্টের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message}/attachments/{attachment}. |
filename |
অ্যাটাচমেন্টের নাম। |
mimeType |
কন্টেন্টের ধরন (MIME টাইপ)। |
source |
অ্যাটাচমেন্টের সোর্স। |
driveFileId |
শুধু আউটপুট। Google Drive ফাইলের আইডি। সোর্স DRIVE_FILE হলে তবেই পপুলেট করা হয়। Google Drive MCP-এর সাথে ব্যবহার করুন। |
ReactionSummary
| JSON উপস্থাপনা |
|---|
{ "emoji": string, "count": integer } |
| ফিল্ড | |
|---|---|
emoji |
ইমোজি ইউনিকোড স্ট্রিং বা কাস্টম ইমোজির নাম। |
count |
সংশ্লিষ্ট ইমোজি ব্যবহার করে মোট কতগুলি প্রতিক্রিয়া জানানো হয়েছে। |
QuotedMessageMetadata
| JSON উপস্থাপনা |
|---|
{ "messageId": string, "lastUpdateTime": string, "quoteType": enum ( |
| ফিল্ড | |
|---|---|
messageId |
শুধু আউটপুট। কোট বা ফরওয়ার্ড করা আসল মেসেজের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message} |
lastUpdateTime |
শুধু আউটপুট। কোট বা ফরওয়ার্ড করার আগে আসল মেসেজ কখন তৈরি বা শেষবার আপডেট করা হয়েছে সেই টাইমস্ট্যাম্প। ফর্ম্যাট: ISO 8601 টাইমস্ট্যাম্প। |
quoteType |
শুধু আউটপুট। কোটের ধরন। |
plaintextBody |
শুধু আউটপুট। কোট বা ফরওয়ার্ড করার সময় আসল মেসেজের টেক্সট বডির স্ন্যাপশট। |
sender |
শুধু আউটপুট। আসল মেসেজের লেখকের ডিসপ্লে নাম। |
attachments[] |
শুধু আউটপুট। আসল মেসেজের অংশ ছিল এমন অ্যাটাচমেন্ট। শুধুমাত্র |
forwardedMetadata |
শুধু আউটপুট। ফরওয়ার্ড করা মেসেজের সোর্স কথোপকথন সম্পর্কে মেটাডেটা। শুধুমাত্র |
ForwardedMetadata
| JSON উপস্থাপনা |
|---|
{ "conversationId": string, "conversationDisplayName": string } |
| ফিল্ড | |
|---|---|
conversationId |
শুধু আউটপুট। সোর্স কথোপকথনের রিসোর্সের নাম। ফর্ম্যাট: spaces/{space} |
conversationDisplayName |
শুধু আউটপুট। মেসেজ ফরওয়ার্ড করার সময় সোর্স কথোপকথনের ডিসপ্লে নাম। নামযুক্ত স্পেসের ক্ষেত্রে, এটি হল স্পেসের নাম। ১:১ সরাসরি মেসেজের ক্ষেত্রে, এটি হল অন্য অংশগ্রহণকারীর নাম। নামহীন গ্রুপ চ্যাটের ক্ষেত্রে, এটি মেম্বারদের নামের উপর ভিত্তি করে তৈরি করা নাম। |
UserType
Google Chat ব্যবহারকারীর ধরন।
| Enums | |
|---|---|
USER_TYPE_UNSPECIFIED |
অনির্দিষ্ট। |
HUMAN |
হিউম্যান ইউজার। |
APP |
অ্যাপ ব্যবহারকারী। |
সোর্স
অ্যাটাচমেন্টের সোর্স।
| Enums | |
|---|---|
SOURCE_UNSPECIFIED |
রিজার্ভ করা হয়েছে। |
DRIVE_FILE |
ফাইলটি Google Drive-এর ফাইল। |
UPLOADED_CONTENT |
ফাইলটি Chat-এ আপলোড করা হয়েছে। |
QuoteType
মেসেজটি কোট করা উত্তর নাকি ফরওয়ার্ড করা মেসেজ তা কোটের ধরন থেকে বোঝা যায়।
| Enums | |
|---|---|
QUOTE_TYPE_UNSPECIFIED |
রিজার্ভ করা হয়েছে। অনির্ধারিত কোটের ধরন। |
REPLY |
মেসেজটি একই থ্রেডে থাকা মূল মেসেজের কোট করা উত্তর। |
FORWARD |
মেসেজটি অন্য কথোপকথনের আসল মেসেজ থেকে বা একই কথোপকথনের অন্য থ্রেড থেকে ফরওয়ার্ড করা হয়েছে। |
টুল অ্যানোটেশন
প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।
টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান ইঙ্গিতগুলি এইভাবে সংজ্ঞায়িত করা হয়েছে:
readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.openWorldHint: সত্য হলে, টুলটি এক্সটার্নাল এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
অনুমোদনের স্কোপ
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
https://www.googleapis.com/auth/chat.messageshttps://www.googleapis.com/auth/chat.messages.readonly