Mettre à jour profilePhoto

  • Article

Espace de noms: microsoft.graph

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

Les tableaux suivants indiquent l’autorisation ou les autorisations les moins privilégiées requises pour appeler cette API sur chaque type de ressource pris en charge. Suivez les bonnes pratiques pour demander des autorisations minimales. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les 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) Group.ReadWrite.All Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

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 Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

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) User.ReadWrite User.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application User.ReadWrite.All Non prise en charge.

Remarque

  • Une application disposant uniquement des autorisations d’application ne peut pas mettre à jour la photo d’un groupe.
  • L’administrateur général et l’administrateur 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 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 :

PATCH /groups/{id}/photo/$value

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 :

PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value

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 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 la photo d’un utilisateur

Demande

L’exemple suivant illustre une demande.

PUT https://graph.microsoft.com/v1.0/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/v1.0/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