MCP Tools Reference: people.googleapis.com

Strumento: search_directory_people

Cerca persone nella directory di Google Workspace della tua organizzazione. Questa funzionalità è disponibile esclusivamente per gli account Google Workspace (utilizzati da aziende, scuole e altre organizzazioni) e non è disponibile per gli Account Google personali.

REGOLE IMPORTANTI DA SEGUIRE:

  • Se questo strumento restituisce più risultati, devi presentarli all'utente e chiedergli di chiarire quale risultato utilizzare prima di procedere.

  • È severamente vietato passare l'output di questo strumento a un altro strumento (ad es. inviare un'email, creare una bozza, creare un evento e così via) senza la conferma esplicita dell'utente.

  • Anche se viene trovato un solo risultato per una persona, devi presentare i dettagli della persona trovata all'utente e chiedergli di verificare che sia la persona prevista prima di procedere con i passaggi successivi.

  • Se questo strumento non restituisce risultati, torna a utilizzare lo strumento search_contacts.

I seguenti esempi mostrano come utilizzare curl per richiamare lo strumento MCP search_directory_people.

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

Schema di input

Messaggio di richiesta per SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

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

string

Stringa di query da cercare.
pageSize

integer

Dimensione della pagina. Il valore predefinito è 10 e il valore massimo consentito è 500.
pageToken

string

Token di pagina.
sources[]

enum (DirectorySourceType)

Origini della directory da restituire. Se non viene impostato, il valore predefinito è DOMAIN_PROFILE.

Schema di output

Messaggio di risposta per SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Rappresentazione JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Campi
results[]

object (SearchDirectoryResult)

L'elenco delle persone che corrispondono alla query.
nextPageToken

string

Un token per recuperare la pagina successiva di risultati.

SearchDirectoryResult

Rappresentazione JSON 
{
  "name": string,
  "email": string
}
Campi
name

string

Il nome visualizzato della persona.
email

string

L'indirizzo email dell'account della persona.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento Open World: ❌