MCP Tools Reference: people.googleapis.com

ابزار: search_directory_people

جستجوی افراد در فهرست Google Workspace سازمان شما. این ویژگی منحصراً برای حساب‌های Google Workspace (مورد استفاده توسط مشاغل، مدارس و سایر سازمان‌ها) است و برای حساب‌های شخصی گوگل در دسترس نیست.

قوانین مهمی که باید رعایت شوند:

  • اگر این ابزار چندین نتیجه را برگرداند، باید نتایج را به کاربر ارائه دهید و قبل از ادامه، از او بخواهید که توضیح دهد از کدام نتیجه استفاده کند.

  • شما اکیداً مجاز به انتقال خروجی این ابزار به ابزار دیگری (مثلاً ارسال ایمیل، ایجاد پیش‌نویس، ایجاد رویداد و غیره) بدون تأیید صریح کاربر نیستید.

  • حتی اگر فقط یک نتیجه برای یک نفر پیدا شود، باید جزئیات فرد پیدا شده را به کاربر ارائه دهید و از کاربر بخواهید قبل از ادامه مراحل، تأیید کند که این همان فرد مورد نظر است.

  • اگر این ابزار هیچ نتیجه‌ای برنگرداند، به استفاده از ابزار search_contacts برگردید.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار search_directory_people MCP را نشان می‌دهد.

درخواست کرل 
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.

جستجودایرکتوریافرادMcpدرخواست

نمایش JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
فیلدها
query

string

رشته پرس و جو برای جستجو.

pageSize

integer

اندازه صفحه. مقدار پیش‌فرض ۱۰ و حداکثر مقدار مجاز ۵۰۰ است.

pageToken

string

نشانه صفحه.

sources[]

enum ( DirectorySourceType )

منابع دایرکتوری برای برگرداندن. اگر تنظیم نشده باشد، پیش‌فرض DOMAIN_PROFILE است.

طرحواره خروجی

پیام پاسخ برای SearchDirectoryPeople.

جستجوفهرست افرادMcpپاسخ

نمایش JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
فیلدها
results[]

object ( SearchDirectoryResult )

لیست افرادی که با عبارت جستجو شده مطابقت داشتند.

nextPageToken

string

یک توکن برای بازیابی صفحه بعدی نتایج.

نتیجه جستجو در دایرکتوری

نمایش JSON 
{
  "name": string,
  "email": string
}
فیلدها
name

string

نام نمایشی شخص.

email

string

آدرس ایمیل حساب کاربری شخص.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌