personName リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ユーザーによって提供された拡張名情報、またはユーザーがプロファイル内で関連付けた拡張名情報を表 します。

itemFacet から継承します。

メソッド

メソッド	戻り値の種類	説明
名前を一覧表示する	personName コレクション	names ナビゲーション プロパティから personName リソースを取得します。
personName を作成する	personName	names ナビゲーション プロパティから新しい personName オブジェクトを作成します。
personName を取得する	personName	personName オブジェクトのプロパティとリレーションシップを読み取ります。
personName を更新する	personName	personName オブジェクトのプロパティを更新します。
personName を削除する	なし	personName オブジェクトを削除します。

プロパティ

プロパティ	型	説明
allowedAudiences	String	エンティティに含まれる値を表示できる対象ユーザー。 itemFacet から継承されます。 可能な値は、me、family、contacts、groupMembers、organization、federatedOrganizations、everyone、unknownFutureValue です。
createdBy	identitySet	エンティティを作成したユーザーまたはアプリケーションの識別子を提供します。 itemFacet から継承されます。
createdDateTime	DateTimeOffset	エンティティが作成されたときの dateTimeOffset を提供します。 itemFacet から継承されます。
displayName	String	ユーザーまたはデバイスのロケールに応じて、firstName と lastName の順序付きレンダリングを提供します。
まずは	String	ユーザーの名。
id	String	エンティティを個別にアドレス指定するために使用される識別子。 エンティティから継承
推論	inferenceData	作成または変更するアプリケーションによってエンティティが推論される場合の推論の詳細が含まれます。 itemFacet から継承されます。
initials	String	ユーザーのイニシャル。
languageTag	String	IETF BCP47 形式に続く言語 (en-US、no-NB、en-AU) の名前が含まれます。
前の	String	ユーザーの姓。
lastModifiedBy	identitySet	エンティティを最後に変更したユーザーまたはアプリケーションの識別子を提供します。 itemFacet から継承されます。
lastModifiedDateTime	DateTimeOffset	エンティティが作成されたときの dateTimeOffset を提供します。 itemFacet から継承されます。
乙女	String	ユーザーの旧姓。
中間	String	ユーザーのミドル ネーム。
ニックネーム	String	ユーザーのニックネーム。
発音	yomiPersonName	ユーザー名の発音方法に関するガイダンス。
source	personDataSource	別のサービスから同期された場合に値が発生した場所。 itemFacet から継承されます。
サフィックス	String	ユーザー名の後に使用される指定子 (例: PhD.)
title	String	ユーザー名の前に付けるために使用される敬語 (例: Dr,Sir, Madam, Mrs.)

リレーションシップ

なし。

JSON 表記

リソースの JSON 表記を次に示します。

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