MCP Tools Reference: people.googleapis.com

כלי: search_directory_people

חיפוש אנשים בסביבת "הארגון שלי" ב-Google Workspace. התכונה הזו מיועדת רק לחשבונות Google Workspace (שמשמשים עסקים, בתי ספר וארגונים אחרים) והיא לא זמינה לחשבונות Google אישיים.

כללים חשובים:

  • אם הכלי הזה מחזיר כמה תוצאות, צריך להציג את התוצאות למשתמש ולבקש ממנו להבהיר איזו תוצאה להשתמש לפני שממשיכים.

  • חל איסור מוחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') ללא אישור מפורש מהמשתמש.

  • גם אם נמצאה רק תוצאה אחת של אדם, אתם צריכים להציג למשתמש את הפרטים של האדם שנמצא ולבקש ממנו לאמת שאכן מדובר באדם הרצוי לפני שתמשיכו לשלבים הבאים.

  • אם הכלי הזה לא מחזיר תוצאות, צריך לחזור להשתמש בכלי search_contacts.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ search_directory_people.

בקשת Curl 
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

טיפוסים בני מנייה (enum)
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