personName Ressourcentyp

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 erweiterte Namensinformationen dar, die vom Benutzer bereitgestellt oder in seinem Profil zugeordnet wurden.

Erbt von itemFacet.

Methoden

Methode Rückgabetyp Beschreibung
List PersonName-Sammlung Rufen Sie die personName-Ressourcen aus der Navigationseigenschaft names ab.
Create personName Erstellen Sie ein neues personName-Objekt aus der Navigationseigenschaft names.
Get personName Lesen der Eigenschaften und Beziehungen eines PersonName-Objekts .
Update personName Aktualisieren Sie die Eigenschaften eines personName-Objekts .
Löschen Keine Löscht ein personName-Objekt .

Eigenschaften

Eigenschaft Typ Beschreibung
allowedAudiences Zeichenfolge Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Die möglichen Werte sind: me, family, contacts, groupMembers, organization, federatedOrganizations, , everyone. unknownFutureValue
createdBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, der bzw. die das Objekt erstellt hat. Geerbt von itemFacet.
createdDateTime DateTimeOffset Stellt den dateTimeOffset für den Zeitpunkt bereit, zu dem die Entität erstellt wurde. Geerbt von itemFacet.
displayName Zeichenfolge Bietet eine geordnete Darstellung von firstName und lastName in Abhängigkeit vom Gebietsschema des Benutzers oder seines Geräts.
Erster Zeichenfolge Vorname des Benutzers.
id Zeichenfolge Bezeichner für die individuelle Adressierung des Objekts. Von Entität geerbt
Rückschluss inferenceData Enthält Rückschlussdetails, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet.
initials String Initialen des Benutzers.
languageTag Zeichenfolge Enthält den Namen für die Sprache (en-US, no-NB, en-AU) gemäß dem IETF BCP47-Format.
Letzte Zeichenfolge Nachname des Benutzers.
lastModifiedBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, der/die die Entität zuletzt geändert hat. Geerbt von itemFacet.
lastModifiedDateTime DateTimeOffset Stellt den dateTimeOffset für den Zeitpunkt bereit, zu dem die Entität erstellt wurde. Geerbt von itemFacet.
Jungfrau Zeichenfolge Mädchenname des Benutzers.
in der Mitte Zeichenfolge Zweiter Vorname des Benutzers.
Spitzname Zeichenfolge Nickname des Benutzers.
Aussprache yomiPersonName Anleitung zum Aussprechen des Benutzernamens.
source personDataSource Ursprung der Werte, wenn sie von einem anderen Dienst synchronisiert wurden. Geerbt von itemFacet.
Suffix Zeichenfolge Bezeichnungen, die nach dem Benutzernamen verwendet werden (z. B. PhD.)
title String Ehrentitel, die verwendet werden, um einem Benutzernamen voranzustellen (z. B. Dr, Sir, Madam, Mrs.)

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.personName",
  "id": "e13f7a4d-303c-464f-a6af-80ea18eb74f3",
  "allowedAudiences": "organization",
  "inference": {
    "@odata.type": "microsoft.graph.inferenceData"
  },
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "source": {
    "@odata.type": "microsoft.graph.personDataSource"
  },
  "displayName": "Innocenty Popov",
  "first": "Innocenty",
  "initials": "IP",
  "last": "Popov",
  "languageTag": "en-US",
  "maiden": null,
  "middle": null,
  "nickname": "Kesha",
  "suffix": null,
  "title": null,
  "pronunciation": {
    "@odata.type": "microsoft.graph.yomiPersonName"
  }
}