MCP Tools Reference: people.googleapis.com

Ferramenta: search_directory_people

Pesquise pessoas no diretório do Google Workspace da sua organização. Esse recurso é exclusivo para contas do Google Workspace (usadas por empresas, escolas e outras organizações) e não está disponível para Contas do Google pessoais.

REGRAS IMPORTANTES A SEGUIR :

  • Se essa ferramenta retornar vários resultados, apresente-os ao usuário e peça esclarecimentos sobre qual resultado usar antes de continuar.

  • É estritamente proibido transmitir a saída dessa ferramenta para outra (por exemplo, enviar um e-mail, criar um rascunho, criar um evento etc.) sem a confirmação explícita do usuário.

  • Mesmo que apenas um resultado de pessoa seja encontrado, apresente os detalhes da pessoa encontrada ao usuário e peça que ele verifique se essa é a pessoa pretendida antes de continuar com as próximas etapas.

  • Se essa ferramenta não retornar resultados, use a ferramenta search_contacts.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP search_directory_people.

Solicitação 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
}'

Esquema de entrada

Mensagem de solicitação para SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Representação JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Campos
query

string

String de consulta a ser pesquisada.
pageSize

integer

Tamanho da página. O padrão é 10 e o valor máximo permitido é 500.
pageToken

string

Token da página.
sources[]

enum (DirectorySourceType)

Fontes de diretório a serem retornadas. O padrão é DOMAIN_PROFILE, caso não esteja definido.

Esquema de saída

Mensagem de resposta para SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Representação JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Campos
results[]

object (SearchDirectoryResult)

A lista de pessoas que correspondem à consulta.
nextPageToken

string

Um token para recuperar a próxima página de resultados.

SearchDirectoryResult

Representação JSON 
{
  "name": string,
  "email": string
}
Campos
name

string

O nome de exibição da pessoa.
email

string

O endereço de e-mail da conta da pessoa.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌