Mettre à jour profilePhoto
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Mettez à jour la photo du contact, du groupe, de l’équipe ou de l’utilisateur spécifié dans un locataire. La taille de la photo que vous pouvez mettre à jour est limitée à 4 Mo.
Vous pouvez utiliser PATCH ou PUT pour cette opération.
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
Pour mettre à jour la photo de profil d’un contact
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | Contacts.ReadWrite | Non prise en charge. |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | Contacts.ReadWrite | Non prise en charge. |
Pour mettre à jour la photo de profil d’un groupe
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
Pour mettre à jour le photo de profil d’une équipe
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
Pour mettre à jour le photo de profil d’un utilisateur
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | ProfilePhoto.ReadWrite.All | User.ReadWrite, User.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | User.ReadWrite | Non prise en charge. |
| Application | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
Remarque
- Les autorisations marquées avec * sont prises en charge uniquement pour la compatibilité descendante. Mettez à jour vos solutions pour utiliser une autre autorisation et évitez d’utiliser ces autorisations à l’avenir.
- Les utilisateurs disposant de rôles d’administrateur tels que Administrateurs d’utilisateurs peuvent mettre à jour la photo de n’importe quel utilisateur dans le organization à l’aide d’autorisations déléguées. Cette opération est également prise en charge avec les autorisations d’application. La mise à jour de la photo d’un utilisateur dans le organization nécessite l’autorisation ProfilePhoto.ReadWrite.All ou User.ReadWrite.All. La mise à jour de la photo de l’utilisateur connecté nécessite uniquement l’autorisation User.ReadWrite .
- La mise à jour de la photo d’un utilisateur à l’aide de Microsoft API Graph n’est actuellement pas prise en charge dans les locataires Azure AD B2C.
Requête HTTP
Pour mettre à jour le photo de profil d’un contact :
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
Pour mettre à jour une photo de groupe :
PUT /groups/{id}/photo/$value
Pour mettre à jour une photo d’équipe :
PUT /teams/{id}/photo/$value
Pour mettre à jour le photo de profil d’un utilisateur :
PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Content-Type | par exemple, image/jpeg. Obligatoire. |
Corps de la demande
Dans le corps de la demande, incluez les données binaires de la photo.
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse ou un 204 No Content code de réponse pour mettre à jour la photo d’une équipe.
Exemples
Exemple 1 : Mettre à jour le photo de profil d’un utilisateur
Demande
L’exemple suivant illustre une demande.
PUT https://graph.microsoft.com/beta/me/photo/$value
Content-type: image/jpeg
Binary data for the image
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 200 OK
Exemple 2 : Mettre à jour la photo d’une équipe
Demande
L’exemple suivant montre une demande de mise à jour d’une photo d’équipe.
PUT https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg
Binary data for the image
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content