MCP Tools Reference: chatmcp.googleapis.com

টুল: list_memberships

একটি গুগল চ্যাট কথোপকথনে সদস্যপদগুলো তালিকাভুক্ত করে।

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

কার্ল অনুরোধ 
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_memberships",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

সদস্যপদ তালিকা অনুরোধ

JSON উপস্থাপনা 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
ক্ষেত্র
conversationId

string

আবশ্যক। যে কথোপকথনের সদস্যপদ তালিকাভুক্ত করতে হবে, তার আইডি। ফরম্যাট: স্পেস/{স্পেস}

pageSize

integer

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

pageToken

string

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

membershipFilter

enum ( MembershipFilter )

ঐচ্ছিক। ফেরত দেওয়ার জন্য মেম্বারশিপের উপসেট নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, শুধুমাত্র JOINED মেম্বারশিপগুলো ফেরত দেওয়া হয়।

সদস্যপদ ফিল্টার

ফেরত দেওয়ার জন্য সদস্যপদগুলির উপসেট নির্দিষ্ট করে।

এনাম
MEMBERSHIP_FILTER_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট থাকলে, শুধুমাত্র যুক্ত সদস্যপদগুলো ফেরত দেওয়া হয়।
JOINED_ONLY শুধুমাত্র যোগদান করা সদস্যপদগুলোই ফেরত দেয়।
JOINED_AND_INVITED যোগদানকৃত এবং আমন্ত্রিত সদস্যপদ ফেরত দেয়।

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

কথোপকথনে সদস্যপদগুলোর তালিকা সম্বলিত প্রতিক্রিয়া।

তালিকা সদস্যপদ প্রতিক্রিয়া

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

object ( Membership )

অনুরোধকৃত কথোপকথনে সদস্যপদসমূহের তালিকা।

nextPageToken

string

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

সদস্যপদ

JSON উপস্থাপনা 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
ক্ষেত্র
member

object ( User )

যে ব্যবহারকারী একজন সদস্য।

state

enum ( State )

শুধুমাত্র আউটপুট। সদস্যপদের অবস্থা।

role

enum ( Role )

সদস্যের ভূমিকা।

ব্যবহারকারী

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

string

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

displayName

string

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

email

string

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

userType

enum ( UserType )

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

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

গুগল চ্যাট ব্যবহারকারীর প্রকারভেদ।

এনাম
USER_TYPE_UNSPECIFIED অনির্দিষ্ট।
HUMAN মানব ব্যবহারকারী।
APP অ্যাপ ব্যবহারকারী।

রাজ্য

সদস্যপদের অবস্থা।

এনাম
STATE_UNSPECIFIED অনির্দিষ্ট।
JOINED ব্যবহারকারী এই পরিসরের একজন সদস্য।
INVITED ব্যবহারকারীকে এই পরিসরে যোগদানের জন্য আমন্ত্রণ জানানো হচ্ছে।

ভূমিকা

সদস্যের ভূমিকা।

এনাম
ROLE_UNSPECIFIED অনির্দিষ্ট।
MEMBER ব্যবহারকারী এই পরিসরের একজন সদস্য।
MANAGER ব্যবহারকারী হলেন স্থানটির ব্যবস্থাপক।
ASSISTANT_MANAGER ব্যবহারকারী এই স্থানটির একজন সহকারী ব্যবস্থাপক।

টুল টীকা

কোনো নির্দিষ্ট টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য টুল অ্যানোটেশনগুলো এমসিপি ক্লায়েন্টদের কাছে পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এই ইঙ্গিতগুলোকে অবিশ্বস্ত হিসেবে গণ্য করে, কিন্তু কখন একজন ব্যবহারকারীকে নিশ্চিতকরণের জন্য প্রম্পট পাঠানো হবে, সেই সিদ্ধান্ত নিতে এগুলো ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিং-এর পাশাপাশি, নিম্নলিখিত বুলিয়ান হিন্টগুলো নিম্নরূপভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint : যদি true হয়, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false।
  • destructiveHint : যদি true হয়, তাহলে টুলটি ধ্বংসাত্মক কাজ করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র সংযোজনমূলক কাজ করতে পারবে। ডিফল্ট: true।
  • idempotentHint : যদি true হয়, তাহলে একই আর্গুমেন্ট দিয়ে টুলটিকে বারবার কল করলেও এর এনভায়রনমেন্টের উপর কোনো অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false।
  • openWorldHint : যদি true হয়, তাহলে টুলটি বাহ্যিক সত্তার 'ওপেন ওয়ার্ল্ড'-এর সাথে ইন্টারঅ্যাক্ট করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র অভ্যন্তরীণ সত্তার সাথে ইন্টারঅ্যাক্ট করতে পারবে। উদাহরণস্বরূপ, একটি ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হবে, কিন্তু একটি মেমরি টুল ওপেন ওয়ার্ল্ড হবে না।

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

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly