person リソースの種類person resource type

名前空間: microsoft.graphNamespace: microsoft.graph

メール、連絡先、ソーシャル ネットワークからの、人物に関する情報の集約です。人物は、個人の連絡先、ソーシャル ネットワーキングの連絡先、組織のディレクトリ、最近 (メール、Skype などで) 連絡した人などになります。An aggregation of information about a person from across mail, contacts, and social networks. People can be local contacts, contacts from social networking or your organization's directory, and people from recent communications (such as email and Skype).


メソッドMethod 戻り値の型Return Type 説明Description
ユーザーを一覧表示するList people 人物person ユーザーへの関連性によって順序付けられた person オブジェクトの集合を取得します。Get a collection of person objects ordered by their relevance to the user.


プロパティProperty Type 説明Description
birthdaybirthday StringString 人物の誕生日。The person's birthday.
companyNamecompanyName StringString 人物の会社名。The name of the person's company.
departmentdepartment StringString 人物の部署。The person's department.
displayNamedisplayName StringString 人物の表示名。The person's display name.
scoredEmailAddressesscoredEmailAddresses scoredEmailAddress コレクションscoredEmailAddress collection 人物の電子メール アドレス。The person's email addresses.
givenNamegivenName StringString 人物に指定された名前。The person's given name.
idid StringString 人物の一意の識別子。読み取り専用です。The person's unique identifier. Read-only.
imAddressimAddress StringString ユーザーのインスタント メッセージ ボイス オーバー IP (VOIP) セッション開始プロトコル (SIP) のアドレス。読み取り専用です。The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.
isFavoriteisFavorite BooleanBoolean ユーザーがこの人物をお気に入りとしてフラグを設定した場合は truetrue if the user has flagged this person as a favorite.
jobTitlejobTitle StringString 人物の役職。The person's job title.
officeLocationofficeLocation StringString 人物のオフィスの所在地。The location of the person's office.
personNotespersonNotes StringString ユーザーがこの人物について記入した自由形式のメモ。Free-form notes that the user has taken about this person.
personTypepersonType personTypepersonType 人物の種類。The type of person.
phonesphones phone コレクションphone collection 人物の電話番号。The person's phone numbers.
postalAddressespostalAddresses location コレクションlocation collection 人物のアドレス。The person's addresses.
professionprofession StringString 人物の職業。The person's profession.
surnamesurname StringString 人物の姓。The person's surname.
userPrincipalNameuserPrincipalName StringString 人物のユーザー プリンシパル名 (UPN)。UPN は、インターネット標準 RFC 822 に基づいた、個人のインターネット スタイルのログイン名です。規則では、これは個人の電子メール名にマップされる必要があります。一般的な書式は alias@domain になります。The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person's email name. The general format is alias@domain.
websiteswebsites website コレクションwebsite collection 人物の Web サイト。The person's websites.
yomiCompanyyomiCompany StringString 人物の会社の日本名の読み仮名。The phonetic Japanese name of the person's company.



JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

  "birthday": "string",
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "scoredEmailAddresses": [{"@odata.type": "microsoft.graph.scoredEmailAddress"}],
  "givenName": "string",
  "id": "string (identifier)",
  "imAddress": "string",
  "isFavorite": true,
  "jobTitle": "string",
  "officeLocation": "string",
  "personNotes": "string",
  "personType": {"@odata.type": "microsoft.graph.personType"},
  "phones": [{"@odata.type": ""}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
  "profession": "string",
  "surname": "string",
  "userPrincipalName": "string",
  "websites": [{"@odata.type": ""}],
  "yomiCompany": "string"