MCP Tools Reference: people.googleapis.com

टूल: search_directory_people

अपने संगठन की Google Workspace डायरेक्ट्री में मौजूद लोगों को खोजें. यह सुविधा सिर्फ़ Google Workspace खातों (कारोबारों, स्कूलों, और अन्य संगठनों के लिए इस्तेमाल किए जाने वाले खाते) के लिए उपलब्ध है. यह निजी Google खातों के लिए उपलब्ध नहीं है.

ज़रूरी नियम:

  • अगर यह टूल एक से ज़्यादा नतीजे दिखाता है, तो आपको उपयोगकर्ता को नतीजे दिखाने चाहिए. साथ ही, आगे बढ़ने से पहले, उपयोगकर्ता से यह भी पूछना चाहिए कि उसे कौनसे नतीजे का इस्तेमाल करना है.

  • उपयोगकर्ता की साफ़ तौर पर पुष्टि के बिना, इस टूल के आउटपुट को किसी दूसरे टूल में पास करने की अनुमति नहीं है. जैसे, ईमेल भेजना, ड्राफ़्ट बनाना, इवेंट बनाना वगैरह.

  • अगर सिर्फ़ एक व्यक्ति का नतीजा मिलता है, तब भी आपको उपयोगकर्ता को उस व्यक्ति की जानकारी दिखानी होगी. साथ ही, आगे बढ़ने से पहले, उपयोगकर्ता से यह भी पूछना होगा कि क्या यह वही व्यक्ति है जिसे वह ढूंढ रहा था.

  • अगर इस टूल से कोई नतीजा नहीं मिलता है, तो search_contacts टूल का इस्तेमाल करें.

यहां दिए गए उदाहरण में, search_directory_people MCP टूल को शुरू करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

Curl का अनुरोध 
curl --location 'https://people.googleapis.com/mcp/v1' \
--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

पेज का साइज़. डिफ़ॉल्ट रूप से, यह 10 होता है. इसकी ज़्यादा से ज़्यादा वैल्यू 500 हो सकती है.
pageToken

string

पेज टोकन.
sources[]

enum (DirectorySourceType)

डायरेक्ट्री के वे सोर्स जिन्हें दिखाना है. अगर यह सेट नहीं किया गया है, तो डिफ़ॉल्ट रूप से, यह DOMAIN_PROFILE पर सेट होता है.

आउटपुट स्कीमा

SearchDirectoryPeople के लिए जवाब का मैसेज.

SearchDirectoryPeopleMcpResponse

JSON के काेड में दिखाना 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
results[]

object (SearchDirectoryResult)

क्वेरी से मैच करने वाले लोगों की सूची.
nextPageToken

string

नतीजों का अगला पेज पाने के लिए टोकन.

SearchDirectoryResult

JSON के काेड में दिखाना 
{
  "name": string,
  "email": string
}
फ़ील्ड
name

string

व्यक्ति का डिसप्ले नेम.
email

string

व्यक्ति के खाते का ईमेल पता.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | रीड ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌