MCP Tools Reference: people.googleapis.com

Araç: search_directory_people

Kuruluşunuzun Google Workspace Dizini'ndeki kullanıcıları arama Bu özellik yalnızca Google Workspace hesaplarında (işletmeler, okullar ve diğer kuruluşlar tarafından kullanılan) kullanılabilir ve kişisel Google Hesaplarında kullanılamaz.

UYULMASI GEREKEN ÖNEMLİ KURALLAR:

  • Bu araç birden fazla sonuç döndürürse sonuçları kullanıcıya göstermeli ve devam etmeden önce hangi sonucun kullanılacağı konusunda kullanıcıdan açıklama istemelisiniz.

  • Bu aracın çıktısını, kullanıcının açık onayı olmadan başka bir araca (ör. e-posta gönderme, taslak oluşturma, etkinlik oluşturma vb.) aktarmanız kesinlikle yasaktır.

  • Yalnızca bir kişi sonucu bulunsa bile, bulunan kişinin ayrıntılarını kullanıcıya sunmanız ve sonraki adımlara geçmeden önce kullanıcının bu kişinin amaçlanan kişi olduğunu doğrulamasını istemeniz gerekir.

  • Bu araç sonuç döndürmezse search_contacts aracını kullanın.

Aşağıdaki örnekte, curl kullanılarak search_directory_people MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

SearchDirectoryPeople için istek mesajı.

SearchDirectoryPeopleMcpRequest

JSON gösterimi 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Alanlar
query

string

Aranacak sorgu dizesi.
pageSize

integer

Sayfa boyutu. Varsayılan değer 10, izin verilen maksimum değer ise 500'dür.
pageToken

string

Sayfa jetonu.
sources[]

enum (DirectorySourceType)

Döndürülecek dizin kaynakları. Ayarlanmamışsa varsayılan olarak DOMAIN_PROFILE olur.

Çıkış şeması

SearchDirectoryPeople için yanıt mesajı.

SearchDirectoryPeopleMcpResponse

JSON gösterimi 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Alanlar
results[]

object (SearchDirectoryResult)

Sorguyla eşleşen kişilerin listesi.
nextPageToken

string

Sonuçların sonraki sayfasını almak için kullanılan jeton.

SearchDirectoryResult

JSON gösterimi 
{
  "name": string,
  "email": string
}
Alanlar
name

string

Kişinin görünen adı.
email

string

Kullanıcının hesap e-posta adresi.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌