Microsoft Graph でのユーザーの操作Working with users in Microsoft Graph

Microsoft Graph を使用し、ユーザー達、他のユーザーやグループとの関係、彼らのメール、予定表、およびファイルに基づいて、魅力的なアプリケーション体験を構築することができます。You can use Microsoft Graph to build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files.

Microsoft Graph を通じて、ふたつの方法で ユーザー にアクセスすることができます。You can access users through Microsoft Graph in two ways:

  • 彼らの ID で、/users/{id | userPrincipalName}By their ID, /users/{id | userPrincipalName}
  • /users/{signed-in user's id} と同じである、サインインしているユーザーの /me エイリアス使用してBy using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}

承認Authorization

ユーザー操作へのアクセスには、次のいずれかの アクセス許可 が必要です。最初の 3 つのアクセス許可は、ユーザーがアプリケーションに付与できます。残りは管理者のみがアプリケーションに付与できます。One of the following permissions is required to access user operations. The first three permissions can be granted to an app by a user. The rest can only be granted to an app by the administrator.

  • User.ReadBasic.AllUser.ReadBasic.All
  • User.ReadUser.Read
  • User.ReadWriteUser.ReadWrite
  • User.Read.AllUser.Read.All
  • User.ReadWrite.AllUser.ReadWrite.All
  • Directory.Read.AllDirectory.Read.All
  • Directory.ReadWrite.AllDirectory.ReadWrite.All
  • Directory.AccessAsUser.AllDirectory.AccessAsUser.All

共通プロパティCommon properties

以下は、ユーザーまたはユーザーの一覧を取得するときに返されるプロパティの既定のセットを表します。The following represent the default set of properties that are returned when getting a user or listing users. これらは、利用可能なすべてのプロパティのサブセットです。These are a subset of all available properties. より多くのユーザー プロパティを取得するには、$select クエリ パラメーターを使用します。To get more user properties, use the $select query parameter.

プロパティProperty 説明Description
idid ユーザーの一意の識別子。The unique identifier for the user.
businessPhonesbusinessPhones ユーザーの電話番号。The user's phone numbers.
displayNamedisplayName アドレス帳に表示されるユーザーの名前。The name displayed in the address book for the user.
givenNamegivenName ユーザーの名。The first name of the user.
jobTitlejobTitle ユーザーの役職。The user's job title.
mailmail ユーザーの電子メール アドレス。The user's email address.
mobilePhonemobilePhone ユーザーの携帯電話番号。The user's cellphone number.
officeLocationofficeLocation ユーザーの物理的なオフィスの場所。The user's physical office location.
preferredLanguagepreferredLanguage ユーザーの選択言語。The user's language of preference.
surnamesurname ユーザーの姓。The last name of the user.
userPrincipalNameuserPrincipalName ユーザーのプリンシパル名。The user's principal name.

詳細と全プロパティの一覧は、ユーザー オブジェクトを参照してください。For details and a list of all the properties, see the user object.

共通の操作Common operations

注: これらの操作のいくつかは、追加のアクセス許可を必要とします。Note: Some of these operations require additional permissions.

パスPath 説明Description
/users 組織内のユーザーを一覧表示します。Lists users in the organization.
/users/{id} Id で特定のユーザーを取得します。Gets a specific user by id.
/users/{id}/photo/$value ユーザーのプロフィール写真を取得します。Gets the user's profile photo.
/users/{id}/manager ユーザーの上司を取得します。Gets the user's manager.
/users/{id}/messages プライマリ受信トレイ内のユーザーの電子メール メッセージを一覧表示します。Lists the user's email messages in their primary inbox.
/users/{id}/events ユーザーの予定表の今後のイベントを一覧表示します。Lists the user's upcoming events in their calendar.
/users/{id}/drive ユーザーの OneDrive ファイル ストアを取得します。Gets the user's OneDrive file store.
/users/{id}/memberOf ユーザーがメンバーであるグループを一覧表示します。Lists the groups that the user is a member of.