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 DIPATUHI:

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

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.

DirectorySourceType

Enum
DOMAIN_PROFILE Profil domain Google Workspace.
DOMAIN_CONTACT Kontak bersama domain Google Workspace.

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: ❌

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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