MCP Tools Reference: people.googleapis.com

টুল: search_contacts

ব্যবহারকারীর পরিচিতি অনুসন্ধান করুন।

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

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

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

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

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` search_contacts 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_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

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

SearchContactsMcpRequest

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

string

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

maxResults

integer

ফলাফলের সর্বোচ্চ সংখ্যা। ডিফল্ট সংখ্যা হলো ১০ এবং সর্বোচ্চ অনুমোদিত মান হলো ৩০।

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

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

SearchContactsMcpResponse

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

object ( SearchContactsResult )

অনুসন্ধানের সাথে মিলে যাওয়া পরিচিতিগুলির তালিকা।

অনুসন্ধানের ফলাফল

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

string

পরিচিতির প্রদর্শিত নাম।

email

string

যোগাযোগকারীর অ্যাকাউন্টের ইমেল ঠিকানা।

টুল টীকা

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

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

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

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