Aktualisieren von profilePhoto
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Aktualisieren Sie das Foto für den angegebenen Kontakt, die Gruppe, das Team oder den Benutzer in einem Mandanten. Die Größe des Fotos, auf das Sie aktualisieren können, ist auf 4 MB beschränkt.
Für diesen Vorgang können Sie patch oder PUT verwenden.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
Um das Profilfoto eines Kontakts zu aktualisieren
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Contacts.ReadWrite | Nicht unterstützt |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Anwendung | Contacts.ReadWrite | Nicht unterstützt |
Um das Profilfoto einer Gruppe zu aktualisieren
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Anwendung | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
So aktualisieren Sie die Profilfoto eines Teams
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Anwendung | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
So aktualisieren Sie die Profilfoto eines Benutzers
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | ProfilePhoto.ReadWrite.All | User.ReadWrite, User.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | User.ReadWrite | Nicht unterstützt |
| Anwendung | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
Hinweis
- Mit * gekennzeichnete Berechtigungen werden nur aus Gründen der Abwärtskompatibilität unterstützt. Aktualisieren Sie Ihre Lösungen, um eine alternative Berechtigung zu verwenden, und vermeiden Sie die Verwendung dieser Berechtigungen in Zukunft.
- Benutzer mit Administratorrollen wie Benutzeradministratoren können das Foto eines beliebigen Benutzers im organization mithilfe delegierter Berechtigungen aktualisieren. Dieser Vorgang wird auch mit Anwendungsberechtigungen unterstützt. Zum Aktualisieren des Fotos eines Benutzers im organization ist die Berechtigung ProfilePhoto.ReadWrite.All oder User.ReadWrite.All erforderlich. Zum Aktualisieren des Fotos des angemeldeten Benutzers ist nur die Berechtigung User.ReadWrite erforderlich.
- Das Aktualisieren des Fotos eines Benutzers mithilfe des Microsoft Graph-API wird derzeit in Azure AD B2C-Mandanten nicht unterstützt.
HTTP-Anforderung
So aktualisieren Sie die Profilfoto eines Kontakts:
PATCH /me/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{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
So aktualisieren Sie ein Gruppenfoto:
PUT /groups/{id}/photo/$value
So aktualisieren Sie ein Teamfoto:
PUT /teams/{id}/photo/$value
So aktualisieren Sie die Profilfoto eines Benutzers:
PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | z.B. image/jpeg. Erforderlich. |
Anforderungstext
Fügen Sie die Binärdaten des Fotos in den Anforderungstext ein.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode oder einen 204 No Content Antwortcode zum Aktualisieren des Fotos eines Teams zurück.
Beispiele
Beispiel 1: Aktualisieren der Profilfoto eines Benutzers
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
PUT https://graph.microsoft.com/beta/me/photo/$value
Content-type: image/jpeg
Binary data for the image
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 200 OK
Beispiel 2: Aktualisieren des Fotos eines Teams
Anforderung
Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren eines Teamfotos.
PUT https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg
Binary data for the image
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content