profilephoto aktualisierenUpdate profilephoto

Namespace: microsoft.graphNamespace: 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.

Aktualisieren Sie das Foto für einen beliebigen Benutzer im Mandanten, einschließlich des angemeldeten Benutzers oder der angegebenen Gruppe oder des Kontakts. Da derzeit ein Grenzwert von 8MB für die Gesamtgröße jeder Rest-Anforderung vorliegt, schränkt dies die Größe des Fotos ein, das Sie unter 8MB hinzufügen können.Update the photo for any user in the tenant including the signed-in user, or the specified group or contact. Since there is currently a limit of 8MB on the total size of each REST request, this limits the size of the photo you can add to under 8MB.

Verwenden Sie für diesen Vorgang nur PUT in der Betaversion.Use only PUT for this operation in the beta version.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Profilfoto des angemeldeten Benutzers:Profile photo of the signed-in user:
User. ReadWrite, User. ReadWrite. allUser.ReadWrite, User.ReadWrite.All

Für group-Ressource:For group resource:
Group.ReadWrite.AllGroup.ReadWrite.All

Für contact-Ressource:For contact resource:
Contacts.ReadWriteContacts.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Für user-Ressource:For user resource:
User.ReadWrite.AllUser.ReadWrite.All

Für group-Ressource:For group resource:
Group.ReadWrite.AllGroup.ReadWrite.All

Für contact-Ressource:For contact resource:
Contacts.ReadWriteContacts.ReadWrite

Hinweis Um das Foto eines Benutzers in der Organisation zu aktualisieren, muss Ihre App über die User.ReadWrite.All-Anwendungsberechtigung verfügen und diese API unter ihrer eigenen Identität und nicht im Auftrag eines Benutzers aufrufen.Note To update the photo of any user in the organization, your app must have the User.ReadWrite.All application permission and call this API under its own identity, not on behalf of a user. Weitere Informationen hierzu finden Sie unter Zugriff ohne einen angemeldeten Benutzer erlangen.To learn more, see get access without a signed-in user.

Hinweis: Es gibt derzeit ein bekanntes Problem beim Zugriff auf Gruppenfotos mithilfe von Anwendungsberechtigungen.Note: There is currently a known issue with accessing group photos using application permissions.

HTTP-AnforderungHTTP request

PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
PUT /groups/{id}/photo/$value
PUT /me/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type image/jpeg. Erforderlich.image/jpeg. Required.

AnforderungstextRequest body

Fügen Sie in den Anforderungstext die Binärdaten des Fotos ein.In the request body, include the binary data of the photo in the request body.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben.If successful, this method returns a 200 OK response code.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

PUT https://graph.microsoft.com/beta/me/photo/$value
Content-type: image/jpeg

Binary data for the image

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK