MCP Tools Reference: chatmcp.googleapis.com

টুল: list_messages

একটি নির্দিষ্ট গুগল চ্যাট কথোপকথন (স্পেস, ডাইরেক্ট মেসেজ (DM) বা গ্রুপ DM) থেকে মেসেজ পুনরুদ্ধার করে। থ্রেড, সময়সীমা এবং মেসেজের সংখ্যা অনুসারে ফিল্টার করার সুবিধা রয়েছে। এছাড়াও, আরও বিস্তারিত তথ্যের জন্য মেসেজের পরবর্তী পৃষ্ঠাটিও পাওয়া যায়। ব্যক্তিগত মেসেজ (যে মেসেজগুলো শুধুমাত্র একজন ব্যবহারকারী দেখতে পান) ফিল্টার করে বাদ দেওয়া হয়।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে list_messages MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--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 tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

ListMessages RPC-এর জন্য অনুরোধ বার্তা।

চ্যাট বার্তা তালিকাভুক্ত করার অনুরোধ

JSON উপস্থাপনা 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
ক্ষেত্র
conversationId

string

আবশ্যক। কথোপকথনের আইডি। একটি কথোপকথন স্পেস, ডিরেক্ট মেসেজ (DM) অথবা গ্রুপ DM/চ্যাট হতে পারে। ফরম্যাট: স্পেস/{স্পেস}

threadId

string

ঐচ্ছিক। কথোপকথনের মধ্যে একটি নির্দিষ্ট থ্রেডের আইডি। এটি প্রদান করা হলে, শুধুমাত্র এই থ্রেডের বার্তাগুলি ফেরত দেওয়া হবে। এটি বাদ দেওয়া হলে, কথোপকথনের সমস্ত থ্রেডের বার্তাগুলি বিবেচনা করা হবে। ফরম্যাট: স্পেস/{স্পেস}/থ্রেড/{থ্রেড}

pageSize

integer

ঐচ্ছিক। ফেরত পাঠানোর জন্য বার্তার সর্বোচ্চ সংখ্যা। পরিষেবাটি এই সংখ্যার চেয়ে কম বার্তাও ফেরত পাঠাতে পারে। নির্দিষ্ট না করা হলে, ডিফল্ট মান ২০ হবে। সর্বোচ্চ অনুমোদিত মান হলো ৫০।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী list_messages কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পেজটি পুনরুদ্ধার করতে এটি প্রদান করুন।

startTime

string

ঐচ্ছিক। বার্তা ফিল্টার করার জন্য ISO 8601 টাইমস্ট্যাম্প। শুধুমাত্র এই সময়ের পরে তৈরি করা বার্তাগুলিই ফেরত দেওয়া হবে।

endTime

string

ঐচ্ছিক। বার্তা ফিল্টার করার জন্য ISO 8601 টাইমস্ট্যাম্প। শুধুমাত্র এই সময়ের আগে তৈরি করা বার্তাগুলোই ফেরত দেওয়া হবে।

আউটপুট স্কিমা

ListMessages RPC-এর প্রতিক্রিয়া বার্তা।

চ্যাট বার্তাগুলির প্রতিক্রিয়া তালিকাভুক্ত করুন

JSON উপস্থাপনা 
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
messages[]

object ( ChatMessage )

সংগৃহীত বার্তাগুলির তালিকা, বিপরীত কালানুক্রমিক ক্রমে (নতুন থেকে নতুন)।

nextPageToken

string

একটি টোকেন, যা পরবর্তী ListMessagesRequest এ page_token হিসেবে পাঠিয়ে বার্তার পরবর্তী পৃষ্ঠাটি আনা যায়। এই ক্ষেত্রটি খালি থাকলে, আর কোনো পৃষ্ঠা নেই।

চ্যাট বার্তা

JSON উপস্থাপনা 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
ক্ষেত্র
messageId

string

বার্তার রিসোর্স নাম। ফরম্যাট: স্পেস/{স্পেস}/বার্তা/{বার্তা}

threadId

string

এই বার্তাটি যে থ্রেডের অন্তর্গত। বার্তাটি আনথ্রেডেড হলে এটি খালি থাকবে। ফরম্যাট: স্পেস/{স্পেস}/থ্রেড/{থ্রেড}

plaintextBody

string

বার্তার মূল অংশটি সাধারণ টেক্সট।

sender

object ( User )

বার্তার প্রেরক।

createTime

string

শুধুমাত্র আউটপুট। বার্তাটি তৈরি হওয়ার সময়কার টাইমস্ট্যাম্প।

threadedReply

boolean

বার্তাটি একটি থ্রেড রিপ্লাই কিনা।

attachments[]

object ( ChatAttachmentMetadata )

বার্তার সাথে সংযুক্ত ফাইলগুলো রয়েছে।

reactionSummaries[]

object ( ReactionSummary )

বার্তাটিতে ইমোজি প্রতিক্রিয়াগুলোর সারাংশ অন্তর্ভুক্ত করা হয়েছে।

ব্যবহারকারী

JSON উপস্থাপনা 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
ক্ষেত্র
userId

string

চ্যাট ব্যবহারকারীর রিসোর্স নাম। ফরম্যাট: users/{user}।

displayName

string

একজন চ্যাট ব্যবহারকারীর প্রদর্শিত নাম।

email

string

ব্যবহারকারীর ইমেল ঠিকানা। এই ক্ষেত্রটি শুধুমাত্র তখনই পূরণ করা হয় যখন ব্যবহারকারীর ধরন মানুষ (HUMAN) হয়।

userType

enum ( UserType )

ব্যবহারকারীর ধরণ।

চ্যাট সংযুক্তি মেটাডেটা

JSON উপস্থাপনা 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
ক্ষেত্র
attachmentId

string

সংযুক্তিটির রিসোর্স নাম। ফরম্যাট: spaces/{space}/messages/{message}/attachments/{attachment}.

filename

string

সংযুক্তিটির নাম।

mimeType

string

বিষয়বস্তুর ধরণ (MIME টাইপ)।

source

enum ( Source )

সংযুক্তিটির উৎস।

প্রতিক্রিয়া সারাংশ

JSON উপস্থাপনা 
{
  "emoji": string,
  "count": integer
}
ক্ষেত্র
emoji

string

ইমোজি ইউনিকোড স্ট্রিং অথবা নিজস্ব ইমোজির নাম।

count

integer

সংশ্লিষ্ট ইমোজি ব্যবহার করে করা মোট প্রতিক্রিয়ার সংখ্যা।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌