個人名リソースの種類

名前空間: microsoft.graph

重要

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

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

Itemfacetから継承します。

メソッド

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

プロパティ

プロパティ	種類	説明
allowedAudiences ユーザー	文字列	エンティティ内に含まれている値を参照できる対象ユーザー。 Itemfacetから継承されます。 可能な値は、me、family、contacts、groupMembers、organization、federatedOrganizations、everyone、unknownFutureValue です。
createdBy	identitySet	エンティティを作成したユーザーまたはアプリケーションの識別子を提供します。 Itemfacetから継承されます。
createdDateTime	DateTimeOffset	エンティティが作成されたときの dateTimeOffset を提供します。 Itemfacetから継承されます。
displayName	文字列	ユーザーまたはデバイスのロケールに応じて、firstName および lastName の順序付きレンダリングを提供します。
まずは	文字列	ユーザーの名。
id	文字列	エンティティに対して個別にアドレス指定するために使用される識別子。 エンティティから継承
推測	inferenceData	エンティティが、アプリケーションの作成または変更によって推論された場合の推論の詳細が含まれます。 Itemfacetから継承されます。
initials	String	ユーザーのイニシャル。
言語タグ	文字列	IETF BCP47 形式の後に、言語名 (en-us、NB なし、en-us) が含まれます。
前の	文字列	ユーザーの姓。
lastModifiedBy	identitySet	エンティティを最後に変更したユーザーまたはアプリケーションの識別子を示します。 Itemfacetから継承されます。
lastModifiedDateTime	DateTimeOffset	エンティティが作成されたときの dateTimeOffset を提供します。 Itemfacetから継承されます。
旧姓	文字列	ユーザーの旧姓。
区分	文字列	ユーザーのミドルネーム。
ニックネーム	文字列	ユーザーのニックネーム。
姓名	ヨーク Mi個人名	ユーザー名を発音する方法に関するガイダンス。
source	個人データソース	値は、別のサービスから同期された場合に発生します。 Itemfacetから継承されます。
字	文字列	ユーザー名の後に使用される指定子 (例: PhD)
title	String	Honorifics ユーザー名のプレフィックスとして使用されます (例: Dr、Sir、Madam、Mr)。

リレーションシップ

なし。

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