Mettre à jour profilePhoto

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.

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

Pour mettre à jour la photo de profil d’un groupe

Pour mettre à jour le photo de profil d’une équipe

Pour mettre à jour le photo de profil d’un utilisateur

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

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

mgc users photo content put --user-id {user-id}

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/me/photo/$value')
	.put(stream);

Import-Module Microsoft.Graph.Users

$params = Binary data for the image

# A UPN can also be used as -UserId.
Set-MgUserPhotoContent -UserId $userId -BodyParameter $params

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

mgc teams photo content put --team-id {team-id}

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value')
	.put(stream);

Import-Module Microsoft.Graph.Teams

$params = Binary data for the image

Set-MgTeamPhotoContent -TeamId $teamId -BodyParameter $params

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content