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

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

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 から 2 つの方法でユーザーにアクセスすることができます。You can access users through Microsoft Graph in two ways:

  • ユーザーの ID で、/users/{id}By their ID, /users/{id}
  • /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
  • User.ManageIdentities.AllUser.ManageIdentities.All
  • Directory.Read.AllDirectory.Read.All
  • Directory.ReadWrite.AllDirectory.ReadWrite.All
  • Directory.AccessAsUser.AllDirectory.AccessAsUser.All

共通プロパティCommon properties

プロパティProperty 説明Description
displayNamedisplayName アドレス帳に表示されるユーザーの名前。The name displayed in the address book for the user.
givenNamegivenName ユーザーの名。The first name of the user.
surnamesurname ユーザーの姓。The last name of the user.
mailmail ユーザーの電子メール アドレス。The user's email address.
photophoto ユーザーのプロフィール写真。The user's profile photo.

詳細と全プロパティの一覧は、user オブジェクトを参照してください。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.
/users/{id}/joinedTeams ユーザーがメンバーである Microsoft Teams を一覧表示します。Lists the Microsoft Teams that the user is a member of.