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	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)	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.

HTTP

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

Binary data for the image

CLI

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

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Users

$params = Binary data for the image

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

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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.

HTTP

PUT https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg

Binary data for the image

CLI

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

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

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')
	.version('beta')
	.put(stream);

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Teams

$params = Binary data for the image

Set-MgBetaTeamPhotoContent -TeamId $teamId -BodyParameter $params

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content