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. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.
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
- User.ManageIdentities.AllUser.ManageIdentities.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. |
NeuerungenWhat's new
Informieren Sie sich über die aktuellsten neuen Features und Updates für diesen API-Satz.Find out about the latest new features and updates for this API set.