MCP Tools Reference: people.googleapis.com

टूल: search_directory_people

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

इन ज़रूरी नियमों का पालन करें:

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

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

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

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

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

कर्ल अनुरोध 
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

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

string

पेज टोकन.
sources[]

enum (DirectorySourceType)

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

DirectorySourceType

Enums
DOMAIN_PROFILE Google Workspace डोमेन प्रोफ़ाइल.
DOMAIN_CONTACT Google Workspace डोमेन के साथ शेयर किया गया संपर्क.

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

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

SearchDirectoryPeopleMcpResponse

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

object (SearchDirectoryResult)

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

string

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

SearchDirectoryResult

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

string

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

string

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

टूल एनोटेशन

डेटा में बदलाव करने से जुड़ी जानकारी: ❌ | एक ही अनुरोध को कई बार भेजने पर भी नतीजे में कोई बदलाव न होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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