MCP Tools Reference: people.googleapis.com

টুল: search_directory_people

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

অনুসরণীয় গুরুত্বপূর্ণ নিয়মাবলী:

  • যদি এই টুলটি একাধিক ফলাফল দেখায়, তবে ব্যবহারকারীকে ফলাফলগুলো উপস্থাপন করুন এবং পরবর্তী ধাপে যাওয়ার আগে কোন ফলাফলটি ব্যবহার করা হবে, সে বিষয়ে তার কাছ থেকে স্পষ্টীকরণ চেয়ে নিন।

  • ব্যবহারকারীর সুস্পষ্ট অনুমতি ছাড়া এই টুলের আউটপুট অন্য কোনো টুলে (যেমন, ইমেল পাঠানো, ড্রাফট তৈরি করা, ইভেন্ট তৈরি করা, ইত্যাদি) পাঠানো কঠোরভাবে নিষিদ্ধ।

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

  • এই টুলটি কোনো ফলাফল না দিলে, search_contacts টুলটি ব্যবহার করুন।

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

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

ইনপুট স্কিমা

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

SearchDirectoryPeopleMcpRequest

JSON উপস্থাপনা 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
ক্ষেত্র
query

string

অনুসন্ধানের জন্য কোয়েরি স্ট্রিং।

pageSize

integer

পৃষ্ঠার আকার। ডিফল্ট মান হলো ১০ এবং সর্বোচ্চ অনুমোদিত মান হলো ৫০০।

pageToken

string

পৃষ্ঠা টোকেন।

sources[]

enum ( DirectorySourceType )

ফেরত দেওয়ার জন্য ডিরেক্টরির উৎসসমূহ। সেট করা না থাকলে এটি ডিফল্টরূপে DOMAIN_PROFILE হিসেবে গণ্য হবে।

ডিরেক্টরি উৎস প্রকার

এনাম
DOMAIN_PROFILE গুগল ওয়ার্কস্পেস ডোমেইন প্রোফাইল।
DOMAIN_CONTACT গুগল ওয়ার্কস্পেস ডোমেইনে শেয়ার করা পরিচিতি।

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

SearchDirectoryPeople-এর জন্য প্রতিক্রিয়া বার্তা।

SearchDirectoryPeopleMcpResponse

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

object ( SearchDirectoryResult )

অনুসন্ধানের সাথে মিলে যাওয়া ব্যক্তিদের তালিকা।

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠাটি পাওয়ার জন্য একটি টোকেন।

অনুসন্ধান ডিরেক্টরি ফলাফল

JSON উপস্থাপনা 
{
  "name": string,
  "email": string
}
ক্ষেত্র
name

string

ব্যক্তিটির প্রদর্শিত নাম।

email

string

ব্যক্তিটির অ্যাকাউন্টের ইমেইল ঠিকানা।

টুল টীকা

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

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

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

  • https://www.googleapis.com/auth/directory.readonly