Personenressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Eine Aggregation von Informationen über eine Person, die über e-Mails, Kontakte und soziale Netzwerke verfügt. Personen können lokale Kontakte, Kontakte aus sozialen Netzwerken, das Verzeichnis Ihrer Organisation und Personen aus kürzlichen Kommunikationen (wie e-Mail und Skype) sein.

Methoden

Methode	Rückgabetyp	Beschreibung
List people	Person	Dient zum Abrufen einer Sammlung von person-Objekten, sortiert nach ihrer Relevanz für den Benutzer.

Eigenschaften

Eigenschaft	Typ	Beschreibung
birthday	Zeichenfolge	Der Geburtstag der Person.
companyName	Zeichenfolge	Der Name des Unternehmens der Person.
department	Zeichenfolge	Die Abteilung der Person.
displayName	Zeichenfolge	Der Anzeigename der Person.
emailAddresses	rankedEmailAddress -Sammlung	Die E-Mail-Adressen der Person.
givenName	Zeichenfolge	Der Vorname der Person.
id	Zeichenfolge	Eindeutiger Bezeichner für die Person. Schreibgeschützt.
isFavorite	Boolescher Wert	true, wenn der Benutzer diese Person als Favorit gekennzeichnet hat.
Mailbox Type	Zeichenfolge	Der Typ des Postfachs, das durch die e-Mail-Adresse der Person dargestellt wird.
officeLocation	Zeichenfolge	Der Bürostandort der Person.
personNotes	Zeichenfolge	Frei formatierbare Notizen, die der Benutzer zu dieser Person hinzugefügt hat.
personType	Zeichenfolge	Der Typ der Person, beispielsweise Verteilerliste.
phones	phone-Sammlung	Die Telefonnummern der Person.
postalAddresses	location-Sammlung	Die Adressen der Person.
profession	Zeichenfolge	Der Beruf der Person.
sources	personDataSource -Sammlung	Die Quellen, aus denen die Benutzerdaten stammen, beispielsweise Verzeichnis-oder Outlook-Kontakte.
surname	Zeichenfolge	Der Nachname der Person.
title	string	Der Titel der Person.
userPrincipalName	string	Der Benutzerprinzipalname der Person. Der UPN ist ein Anmeldename der Person im Internetformat, der auf dem Internetstandard RFC 822 basiert. Gemäß der Konvention sollte er dem E-Mail-Namen der Person zugeordnet sein. Das allgemeine Format lautet alias@domäne.
websites	website-Sammlung	Die Websites der Person.
yomiCompany	Zeichenfolge	Der phonetische japanische Firmenname des Unternehmens der Person.

Beziehungen

Keine

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "birthday": "string",
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "string",
  "id": "string (identifier)",
  "isFavorite": true,
  "mailboxType": "string",
  "officeLocation": "string",
  "personNotes": "string",
  "personType": "string",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "string",
  "sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
  "surname": "string",
  "title": "string",
  "userPrincipalName": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "yomiCompany": "string"
}