person リソースの種類

名前空間: microsoft.graph

重要

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

メール、連絡先、ソーシャルネットワークにわたる個人に関する情報の集約。ユーザーは、ローカルの連絡先、ソーシャルネットワーキングからの連絡先、組織のディレクトリ、および最近のコミュニケーション (電子メールや Skype など) の人物であることができます。

メソッド

メソッド	戻り値の型	説明
ユーザーを一覧表示する	人物	ユーザーへの関連性によって順序付けられた person オブジェクトの集合を取得します。

プロパティ

プロパティ	型	説明
birthday	string	人物の誕生日。
companyName	string	人物の会社名。
department	string	人物の部署。
displayName	string	人物の表示名。
emailAddresses	Rankedemailaddress コレクション	人物の電子メール アドレス。
givenName	string	人物に指定された名前。
id	string	人物の一意の識別子。読み取り専用です。
isFavorite	ブール値	ユーザーがこの人物をお気に入りとしてフラグを設定した場合は true。
mailboxType	string	ユーザーの電子メールアドレスによって表されるメールボックスの種類。
officeLocation	string	人物のオフィスの所在地。
personNotes	string	ユーザーがこの人物について記入した自由形式のメモ。
personType	string	ユーザーの種類 (例: 配布リスト)。
phones	phone コレクション	人物の電話番号。
postalAddresses	location コレクション	人物のアドレス。
profession	string	人物の職業。
sources	個人データソース コレクション	ユーザーデータの取得元となるソース (ディレクトリまたは Outlook 連絡先など)。
surname	string	人物の姓。
title	string	個人の役職。
userPrincipalName	string	人物のユーザー プリンシパル名 (UPN)。UPN は、インターネット標準 RFC 822 に基づいた、個人のインターネット スタイルのログイン名です。規則では、これは個人の電子メール名にマップされる必要があります。一般的な書式は alias@domain になります。
websites	website コレクション	人物の Web サイト。
yomiCompany	string	人物の会社の日本名の読み仮名。

リレーションシップ

なし

JSON 表記

以下は、リソースの JSON 表記です。

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