MCP Tools Reference: chatmcp.googleapis.com

টুল: 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

string

প্রয়োজনীয়। কথোপকথনের আইডি। কথোপকথন বলতে স্পেস, সরাসরি মেসেজ (DM) বা গ্রুপ DM/চ্যাট বোঝায়। ফর্ম্যাট: spaces/{space}

threadId

string

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

pageSize

integer

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

pageToken

string

ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, যা আগের list_messages কল থেকে পাওয়া গেছে। পরবর্তী পৃষ্ঠাটি ফিরিয়ে আনতে এটি প্রদান করুন।

startTime

string

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

endTime

string

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

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

অনুরোধ করা কথোপকথন থেকে মেসেজের তালিকা সহ উত্তর।

ListChatMessagesResponse

JSON উপস্থাপনা
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
messages[]

object (ChatMessage)

মেসেজের তালিকা বিপরীত কালানুক্রমিক ক্রমে (সবচেয়ে নতুন মেসেজ প্রথমে) ফিরিয়ে আনা হয়েছে।

nextPageToken

string

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

ChatMessage

JSON উপস্থাপনা
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ],
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  }
}
ফিল্ড
messageId

string

মেসেজের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message}

threadId

string

এই মেসেজটি যে থ্রেডের অন্তর্গত। মেসেজটি থ্রেড করা না থাকলে এটি খালি থাকবে। ফর্ম্যাট: spaces/{space}/threads/{thread}

plaintextBody

string

মার্কডাউন ফর্ম্যাটিং ব্যবহার করে মেসেজের টেক্সট বডি।

sender

object (User)

মেসেজের প্রেরক।

createTime

string

শুধু আউটপুট। মেসেজটি কখন তৈরি করা হয়েছিল সেই টাইমস্ট্যাম্প। ফর্ম্যাট: ISO 8601 টাইমস্ট্যাম্প।

threadedReply

boolean

মেসেজটি থ্রেডের উত্তর কিনা।

attachments[]

object (ChatAttachmentMetadata)

মেসেজে অ্যাটাচমেন্ট যোগ করা হয়েছে।

reactionSummaries[]

object (ReactionSummary)

মেসেজে ইমোজি প্রতিক্রিয়ার সারসংক্ষেপ অন্তর্ভুক্ত করা হয়েছে।

quotedMessageMetadata

object (QuotedMessageMetadata)

শুধু আউটপুট। এই মেসেজে উদ্ধৃত বা ফরওয়ার্ড করা আসল মেসেজ সম্পর্কে তথ্য। মনে রাখবেন: এই ফিল্ডটি এখনও ডেভেলপ করা হচ্ছে এবং সব পরিবেশে এখনও উপলভ্য নাও হতে পারে।

ব্যবহারকারী

JSON উপস্থাপনা
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
ফিল্ড
userId

string

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

displayName

string

Chat ব্যবহারকারীর ডিসপ্লে নাম।

email

string

ব্যবহারকারীর ইমেল আইডি। ব্যবহারকারীর ধরন HUMAN হলে তবেই এই ফিল্ডে তথ্য দেখানো হয়।

userType

enum (UserType)

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

ChatAttachmentMetadata

JSON উপস্থাপনা
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source),
  "driveFileId": string
}
ফিল্ড
attachmentId

string

অ্যাটাচমেন্টের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message}/attachments/{attachment}.

filename

string

অ্যাটাচমেন্টের নাম।

mimeType

string

কন্টেন্টের ধরন (MIME টাইপ)।

source

enum (Source)

অ্যাটাচমেন্টের সোর্স।

driveFileId

string

শুধু আউটপুট। Google Drive ফাইলের আইডি। সোর্স DRIVE_FILE হলে তবেই পপুলেট করা হয়। Google Drive MCP-এর সাথে ব্যবহার করুন।

ReactionSummary

JSON উপস্থাপনা
{
  "emoji": string,
  "count": integer
}
ফিল্ড
emoji

string

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

count

integer

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

QuotedMessageMetadata

JSON উপস্থাপনা
{
  "messageId": string,
  "lastUpdateTime": string,
  "quoteType": enum (QuoteType),
  "plaintextBody": string,
  "sender": string,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "forwardedMetadata": {
    object (ForwardedMetadata)
  }
}
ফিল্ড
messageId

string

শুধু আউটপুট। কোট বা ফরওয়ার্ড করা আসল মেসেজের রিসোর্স নাম। ফর্ম্যাট: spaces/{space}/messages/{message}

lastUpdateTime

string

শুধু আউটপুট। কোট বা ফরওয়ার্ড করার আগে আসল মেসেজ কখন তৈরি বা শেষবার আপডেট করা হয়েছে সেই টাইমস্ট্যাম্প। ফর্ম্যাট: ISO 8601 টাইমস্ট্যাম্প।

quoteType

enum (QuoteType)

শুধু আউটপুট। কোটের ধরন।

plaintextBody

string

শুধু আউটপুট। কোট বা ফরওয়ার্ড করার সময় আসল মেসেজের টেক্সট বডির স্ন্যাপশট। FORWARD-এর জন্য মার্কডাউন এবং REPLY-এর জন্য প্লেন টেক্সট ব্যবহার করে ফর্ম্যাট করা হয়েছে।

sender

string

শুধু আউটপুট। আসল মেসেজের লেখকের ডিসপ্লে নাম।

attachments[]

object (ChatAttachmentMetadata)

শুধু আউটপুট। আসল মেসেজের অংশ ছিল এমন অ্যাটাচমেন্ট। শুধুমাত্র FORWARD কোটের ধরনের জন্য পপুলেট করা হয়েছে।

forwardedMetadata

object (ForwardedMetadata)

শুধু আউটপুট। ফরওয়ার্ড করা মেসেজের সোর্স কথোপকথন সম্পর্কে মেটাডেটা। শুধুমাত্র FORWARD কোটের ধরনের জন্য পপুলেট করা হয়েছে।

ForwardedMetadata

JSON উপস্থাপনা
{
  "conversationId": string,
  "conversationDisplayName": string
}
ফিল্ড
conversationId

string

শুধু আউটপুট। সোর্স কথোপকথনের রিসোর্সের নাম। ফর্ম্যাট: spaces/{space}

conversationDisplayName

string

শুধু আউটপুট। মেসেজ ফরওয়ার্ড করার সময় সোর্স কথোপকথনের ডিসপ্লে নাম। নামযুক্ত স্পেসের ক্ষেত্রে, এটি হল স্পেসের নাম। ১:১ সরাসরি মেসেজের ক্ষেত্রে, এটি হল অন্য অংশগ্রহণকারীর নাম। নামহীন গ্রুপ চ্যাটের ক্ষেত্রে, এটি মেম্বারদের নামের উপর ভিত্তি করে তৈরি করা নাম।

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.messages
  • https://www.googleapis.com/auth/chat.messages.readonly