Personenressourcentyp

Artikel
23.07.2024

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Aggregation von Informationen über eine Person aus allen E-Mails und Kontakten dar. Personen können lokale Kontakte oder das Verzeichnis Ihrer Organisation und Personen aus der letzten Kommunikation (z. B. E-Mail) 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	String	Der Geburtstag der Person.
companyName	String	Der Name des Unternehmens der Person.
department	String	Die Abteilung der Person.
displayName	String	Der Anzeigename der Person.
emailAddresses	rankedEmailAddress-Sammlung	Die E-Mail-Adressen der Person.
givenName	String	Der Vorname der Person.
id	String	Der eindeutige Bezeichner der Person. Schreibgeschützt.
isFavorite	Boolesch	`True`, wenn der Benutzer diese Person als Favorit gekennzeichnet hat.
mailboxType	Zeichenfolge	Der Postfachtyp, der durch die E-Mail-Adresse der Person dargestellt wird.
officeLocation	String	Der Bürostandort der Person.
personNotes	String	Frei formatierbare Notizen, die der Benutzer zu dieser Person hinzugefügt hat.
personType	Zeichenfolge	Der Typ der Person, z. B. Verteilerliste.
phones	phone-Sammlung	Die Telefonnummern der Person.
postalAddresses	location-Sammlung	Die Adressen der Person.
profession	String	Der Beruf der Person.
sources	personDataSource-Sammlung	Die Quellen, aus den die Benutzerdaten stammen, z. B. Verzeichnis oder Outlook-Kontakte.
surname	String	Der Nachname der Person.
title	String	Der Titel der Person.
userPrincipalName	String	Der Benutzerprinzipalname (UPN) der Person. Der UPN ist ein Anmeldename im Internetstil für die Person, die auf dem Internetstandard RFC 822 basiert. Standardmäßig sollte dies dem E-Mail-Namen der Person zugeordnet werden. Das allgemeine Format ist `alias@domain`.
websites	website-Sammlung	Die Websites der Person.
yomiCompany	String	Der phonetische japanische Firmenname des Unternehmens der Person.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

JSON

{
  "birthday": "String",
  "companyName": "String",
  "department": "String",
  "displayName": "String",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "String",
  "id": "String (identifier)",
  "isFavorite": "Boolean",
  "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"
}

Freigeben über