MCP Tools Reference: people.googleapis.com

Tool: search_directory_people

Suche nach Personen im Google Workspace-Verzeichnis Ihrer Organisation. Diese Funktion ist ausschließlich für Google Workspace-Konten (die von Unternehmen, Schulen und anderen Organisationen verwendet werden) verfügbar und nicht für private Google-Konten.

WICHTIGE REGELN :

  • Wenn dieses Tool mehrere Ergebnisse zurückgibt, sollten Sie dem Nutzer die Ergebnisse präsentieren und ihn um eine Klarstellung bitten, welches Ergebnis verwendet werden soll, bevor Sie fortfahren.

  • Es ist strengstens untersagt, die Ausgabe dieses Tools ohne ausdrückliche Bestätigung des Nutzers an ein anderes Tool zu übergeben (z. B. eine E‑Mail zu senden, einen Entwurf zu erstellen oder ein Ereignis zu erstellen).

  • Auch wenn nur ein Personenergebnis gefunden wird, müssen Sie dem Nutzer die Details der gefundenen Person präsentieren und ihn bitten, zu bestätigen, dass es sich um die gewünschte Person handelt, bevor Sie mit den weiteren Schritten fortfahren.

  • Wenn dieses Tool keine Ergebnisse zurückgibt, verwenden Sie stattdessen das Tool search_contacts.

Das folgende Beispiel zeigt, wie Sie curl verwenden, um das MCP-Tool search_directory_people aufzurufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

JSON-Darstellung 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Felder
query

string

Suchstring.
pageSize

integer

Die Seitengröße. Der Standardwert ist 10 und der maximal zulässige Wert ist 500.
pageToken

string

Seitentoken
sources[]

enum (DirectorySourceType)

Verzeichnisquellen, die zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, wird standardmäßig DOMAIN_PROFILE verwendet.

Ausgabeschema

Antwortnachricht für SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

JSON-Darstellung 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Felder
results[]

object (SearchDirectoryResult)

Die Liste der Personen, die der Abfrage entsprechen.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann.

SearchDirectoryResult

JSON-Darstellung 
{
  "name": string,
  "email": string
}
Felder
name

string

Der Anzeigename der Person.
email

string

Die E‑Mail-Adresse des Kontos der Person.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌