MCP Tools Reference: people.googleapis.com

Công cụ: search_directory_people

Tìm kiếm người dùng trong thư mục Google Workspace của tổ chức bạn. Tính năng này chỉ dành cho tài khoản Google Workspace (do doanh nghiệp, trường học và các tổ chức khác sử dụng) và không dành cho Tài khoản Google cá nhân.

CÁC QUY TẮC QUAN TRỌNG CẦN TUÂN THỦ:

  • Nếu công cụ này trả về nhiều kết quả, bạn nên trình bày các kết quả đó cho người dùng và nhắc người dùng làm rõ kết quả nào cần sử dụng trước khi tiếp tục.

  • Bạn tuyệt đối không được chuyển đầu ra của công cụ này sang một công cụ khác (ví dụ: gửi email, tạo bản nháp, tạo sự kiện, v.v.) mà không có sự xác nhận rõ ràng của người dùng.

  • Ngay cả khi chỉ tìm thấy kết quả của một người, bạn vẫn phải trình bày thông tin chi tiết của người đó cho người dùng và nhắc người dùng xác minh rằng đây là người mà họ muốn tìm trước khi tiếp tục các bước tiếp theo.

  • Nếu công cụ này không trả về kết quả nào, hãy chuyển sang sử dụng công cụ search_contacts.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP search_directory_people.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Biểu diễn dưới dạng JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Trường
query

string

Chuỗi truy vấn để tìm kiếm.
pageSize

integer

Kích thước trang. Giá trị mặc định là 10 và giá trị tối đa được phép là 500.
pageToken

string

Mã thông báo trang.
sources[]

enum (DirectorySourceType)

Các nguồn thư mục cần trả về. Mặc định là DOMAIN_PROFILE nếu không được đặt.

DirectorySourceType

Enum
DOMAIN_PROFILE Hồ sơ miền Google Workspace.
DOMAIN_CONTACT Danh bạ dùng chung của miền Google Workspace.

Giản đồ đầu ra

Thông báo phản hồi cho SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Biểu diễn dưới dạng JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Trường
results[]

object (SearchDirectoryResult)

Danh sách những người khớp với truy vấn.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo.

SearchDirectoryResult

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "email": string
}
Trường
name

string

Tên hiển thị của người đó.
email

string

Địa chỉ email của tài khoản của người đó.

Chú giải công cụ

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

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