MCP Tools Reference: people.googleapis.com

Alat: search_directory_people

Menelusuri orang dalam direktori Google Workspace organisasi Anda. Fitur ini khusus untuk akun Google Workspace (yang digunakan oleh bisnis, sekolah, dan organisasi lainnya) dan tidak tersedia untuk Akun Google pribadi.

ATURAN PENTING YANG HARUS DIIKUTI:

  • Jika alat ini menampilkan beberapa hasil, Anda harus menampilkan hasil tersebut kepada pengguna dan meminta pengguna untuk mengklarifikasi hasil mana yang akan digunakan sebelum melanjutkan.

  • Anda dilarang keras meneruskan output alat ini ke alat lain (misalnya, mengirim email, membuat draf, membuat acara, dll.) tanpa konfirmasi eksplisit dari pengguna.

  • Meskipun hanya satu hasil orang yang ditemukan, Anda harus menampilkan detail orang yang ditemukan kepada pengguna dan meminta pengguna untuk memverifikasi bahwa orang tersebut adalah orang yang dimaksud sebelum melanjutkan ke langkah selanjutnya.

  • Jika alat ini tidak menampilkan hasil, gunakan alat search_contacts.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_directory_people.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Representasi JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Kolom
query

string

String kueri yang akan ditelusuri.
pageSize

integer

Ukuran halaman. Nilai defaultnya adalah 10 dan nilai maksimum yang diizinkan adalah 500.
pageToken

string

Token halaman.
sources[]

enum (DirectorySourceType)

Sumber direktori yang akan ditampilkan. Jika tidak ditetapkan, defaultnya adalah DOMAIN_PROFILE.

Skema Output

Pesan respons untuk SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Representasi JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Kolom
results[]

object (SearchDirectoryResult)

Daftar orang yang cocok dengan kueri.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya.

SearchDirectoryResult

Representasi JSON 
{
  "name": string,
  "email": string
}
Kolom
name

string

Nama tampilan orang tersebut.
email

string

Alamat email akun orang tersebut.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌