Arbeiten mit Benutzern in Microsoft GraphWorking with users in Microsoft Graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Mit Microsoft Graph können Sie überzeugende App-Erfahrung basierend auf Benutzern, Beziehungen mit anderen Benutzern und Gruppen, und E-Mails, Kalender und Dateien bieten.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.

Sie können auf zwei Arten über Microsoft Graph auf Benutzer zugreifen:You can access users through Microsoft Graph in two ways:

  • Anhand der ID, /users/{id}By their ID, /users/{id}
  • Anhand des /me-Alias für den angemeldeten Benutzer, welcher /users/{signed-in user's id} entsprichtBy using the /me alias for the signed-in user, which is the same as /users/{signed-in user's id}

AutorisierungAuthorization

Für den Zugriff auf Benutzervorgänge ist eine der folgenden Berechtigungen erforderlich. Die ersten drei Berechtigungen können einer App durch einen Benutzer gewährt werden. Die übrigen können der App nur durch einen Administrator gewährt werden.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

Allgemeine EigenschaftenCommon properties

EigenschaftProperty BeschreibungDescription
displayNamedisplayName Der Name des Benutzers, der im Adressbuch angezeigt wird.The name displayed in the address book for the user.
givenNamegivenName Der Vorname des Benutzers.The first name of the user.
surnamesurname Der Nachname des Benutzers.The last name of the user.
mailmail Die E-Mail-Adresse des Benutzers.The user's email address.
photophoto Das Profilfoto des Benutzers.The user's profile photo.

Weitere Informationen und eine Liste aller Eigenschaften finden Sie unter user-Objekt.For details and a list of all the properties, see the user object.

Allgemeine VorgängeCommon operations

Hinweis: Einige dieser Vorgänge erfordern zusätzliche Berechtigungen.Note: Some of these operations require additional permissions.

PfadPath BeschreibungDescription
/users Listet die Benutzer in der Organisation auf.Lists users in the organization.
/users/{id} Ruft einen bestimmten Benutzer anhand der ID ab.Gets a specific user by id.
/users/{id}/photo/$value Ruft das Profilfoto des Benutzers ab.Gets the user's profile photo.
/users/{id}/manager Ruft den Vorgesetzten des Benutzers ab.Gets the user's manager.
/users/{id}/messages Listet die E-Mails des Benutzers im primären Posteingang auf.Lists the user's email messages in their primary inbox.
/users/{id}/events Listet bevorstehende Ereignisse des Benutzers im Kalender auf.Lists the user's upcoming events in their calendar.
/users/{id}/drive Ruft den OneDrive-Dateispeicher des Benutzers ab.Gets the user's OneDrive file store.
/users/{id}/memberOf Listet die Gruppen auf, deren Mitglied der Benutzer ist.Lists the groups that the user is a member of.
/users/{id}/joinedTeams Listet die Microsoft Teams auf, deren Mitglied der Benutzer ist.Lists the Microsoft Teams that the user is a member of.