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 informationen zu erweiterten Namen dar, die vom Benutzer bereitgestellt werden oder die er innerhalb seines Profils zugeordnet hat.

Erbt von itemFacet.

Methoden

Methode Rückgabetyp Beschreibung
Namen auflisten personName-Sammlung Rufen Sie die personName-Ressourcen aus der Names-Navigationseigenschaft ab.
PersonName erstellen Personname Erstellen Sie ein neues personName-Objekt aus der Names-Navigationseigenschaft.
PersonName abrufen Personname Liest die Eigenschaften und Beziehungen eines personName-Objekts .
PersonName aktualisieren Personname Aktualisieren sie die Eigenschaften eines personName-Objekts .
PersonName löschen Keine Löscht ein personName-Objekt .

Eigenschaften

Eigenschaft Typ Beschreibung
allowedAudiences String Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Mögliche Werte: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
createdBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, der die Entität erstellt hat. Geerbt von itemFacet.
createdDateTime DateTimeOffset Stellt dateTimeOffset für den Zeitpunkt der Erstellung der Entität bereit. Geerbt von itemFacet.
displayName String Stellt ein geordnetes Rendering von firstName und lastName bereit, abhängig vom Gebietsschema des Benutzers oder seines Geräts.
Ersten String Vorname des Benutzers.
id String Bezeichner, der für die individuelle Adressierung der Entität verwendet wird. Geerbt von der Entität
Ableitung 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 String Enthält den Namen für die Sprache (en-US, no-NB, en-AU) im IETF BCP47-Format.
letzte String Nachname des Benutzers.
lastModifiedBy identitySet Stellt den Bezeichner des Benutzers und/oder der Anwendung bereit, der die Entität zuletzt geändert hat. Geerbt von itemFacet.
lastModifiedDateTime DateTimeOffset Stellt dateTimeOffset für den Zeitpunkt der Erstellung der Entität bereit. Geerbt von itemFacet.
Jungfrau String Mädchenname des Benutzers.
Mitte String Zweiter Name des Benutzers.
Spitzname String Spitzname des Benutzers.
Aussprache yomiPersonName Anleitungen zur Aussprache des Benutzernamens.
source personDataSource Woher die Werte stammen, wenn sie von einem anderen Dienst synchronisiert werden. Geerbt von itemFacet.
Suffix String Bezeichner, die nach dem Benutzernamen verwendet werden (z. B. PhD.)
title String Honorifics, die zum Präfix eines Benutzernamens verwendet werden (z.B.: Dr, Sir, Madam, Mrs.)

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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