MCP Tools Reference: people.googleapis.com

Tool: search_directory_people

Suchen Sie im Google Workspace-Verzeichnis Ihrer Organisation nach Personen. Diese Funktion ist ausschließlich für Google Workspace-Konten (die von Unternehmen, Bildungseinrichtungen 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 Ihnen 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 Ergebnis für eine Person gefunden wird, müssen Sie dem Nutzer die Details der gefundenen Person präsentieren und ihn auffordern, zu bestätigen, dass es sich um die gewünschte Person handelt, bevor Sie mit weiteren Schritten fortfahren.

  • Wenn dieses Tool keine Ergebnisse liefert, verwenden Sie stattdessen das Tool search_contacts.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool search_directory_people aufrufen.

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

Eingabeschema

Anfragenachricht für SearchDirectoryPeople

SearchDirectoryPeopleMcpRequest

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

string

Abfragestring für die Suche.
pageSize

integer

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

string

Seitentoken
sources[]

enum (DirectorySourceType)

Zurückzugebende Verzeichnisquellen. Wenn kein Wert festgelegt ist, wird der Standardwert DOMAIN_PROFILE verwendet.

DirectorySourceType

Enums
DOMAIN_PROFILE Google Workspace-Domainprofil.
DOMAIN_CONTACT Gemeinsamer Kontakt in der Google Workspace-Domain.

Ausgabeschema

Antwortnachricht für SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

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

object (SearchDirectoryResult)

Die Liste der Personen, die der Anfrage 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.

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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