Personenressourcentyp

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.

{
  "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"
}