Personenressourcentypperson resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Eine Aggregation von Informationen über eine Person aus e-Mails, Kontakten und sozialen Netzwerken.An aggregation of information about a person from across mail, contacts and social networks. Personen können lokale Kontakte, Kontakte aus sozialen Netzwerken, das Verzeichnis Ihrer Organisation und Personen aus der letzten Kommunikation (wie e-Mail und Skype) sein.People can be local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
List peopleList people Personperson Dient zum Abrufen einer Sammlung von person-Objekten, sortiert nach ihrer Relevanz für den Benutzer.Get a collection of person objects ordered by their relevance to the user.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
birthdaybirthday stringstring Der Geburtstag der Person.The person's birthday.
companyNamecompanyName stringstring Der Name des Unternehmens der Person.The name of the person's company.
departmentdepartment stringstring Die Abteilung der Person.The person's department.
displayNamedisplayName Stringstring Der Anzeigename der Person.The person's display name.
emailAddressesemailAddresses rankedEmailAddress -SammlungrankedEmailAddress collection Die E-Mail-Adressen der Person.The person's email addresses.
givenNamegivenName stringstring Der Vorname der Person.The person's given name.
idid stringstring Eindeutiger Bezeichner für die Person. Schreibgeschützt.The person's unique identifier. Read-only.
isFavoriteisFavorite Boolescher Wertboolean true, wenn der Benutzer diese Person als Favorit gekennzeichnet hat.true if the user has flagged this person as a favorite.
Mailbox TypemailboxType stringstring Der Typ des Postfachs, das von der e-Mail-Adresse der Person dargestellt wird.The type of mailbox that is represented by the person's email address.
officeLocationofficeLocation stringstring Der Bürostandort der Person.The location of the person's office.
personNotespersonNotes stringstring Frei formatierbare Notizen, die der Benutzer zu dieser Person hinzugefügt hat.Free-form notes that the user has taken about this person.
personTypepersonType stringstring Der Typ der Person, beispielsweise Verteilerliste.The type of person, for example distribution list.
phonesphones phone-Sammlungphone collection Die Telefonnummern der Person.The person's phone numbers.
postalAddressespostalAddresses location-Sammlunglocation collection Die Adressen der Person.The person's addresses.
professionprofession stringstring Der Beruf der Person.The person's profession.
sourcessources personDataSource -SammlungpersonDataSource collection Die Quellen, aus denen die Benutzerdaten stammen, beispielsweise Verzeichnis-oder Outlook-Kontakte.The sources the user data comes from, for example Directory or Outlook Contacts.
surnamesurname stringstring Der Nachname der Person.The person's surname.
titletitle stringstring Der Titel der Person.The person's title.
userPrincipalNameuserPrincipalName stringstring 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.The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person's email name. The general format is alias@domain.
websiteswebsites website-Sammlungwebsite collection Die Websites der Person.The person's websites.
yomiCompanyyomiCompany stringstring Der phonetische japanische Firmenname des Unternehmens der Person.The phonetic Japanese name of the person's company.

BeziehungenRelationships

KeineNone

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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