Actualizar profilePhoto

Artículo
02/23/2024

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Actualice la foto del contacto, grupo, equipo o usuario especificados en un inquilino. El tamaño de la foto a la que puede actualizar está limitado a 4 MB.

Puede usar PATCH o PUT para esta operación.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permissions

Para actualizar la foto de perfil de un contacto

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Contacts.ReadWrite	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Contacts.ReadWrite	No admitida.

Para actualizar la foto de perfil de un grupo

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Group.ReadWrite.All	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	No admitida.	No admitida.

Para actualizar la foto de perfil de un equipo

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	TeamSettings.ReadWrite.All	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	No admitida.	No admitida.

Para actualizar la foto de perfil de un usuario

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	User.ReadWrite	User.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	User.ReadWrite.All	No admitida.

Nota:

Una aplicación con solo permisos de aplicación no puede actualizar la foto de un grupo.
Los permisos marcados con * solo se admiten para la compatibilidad con versiones anteriores. Actualice las soluciones para usar un permiso alternativo y evite el uso de estos permisos en el futuro.
El administrador global y el administrador de usuarios pueden actualizar la foto de cualquier usuario de la organización mediante permisos delegados. Esta operación también se admite con permisos de aplicación. La actualización de la foto de cualquier usuario de la organización requiere el permiso User.ReadWrite.All . La actualización de la foto del usuario que ha iniciado sesión solo requiere el permiso User.ReadWrite .
La actualización de la foto de un usuario mediante microsoft Graph API no se admite actualmente en los inquilinos de Azure AD B2C.

Solicitud HTTP

Para actualizar la foto de perfil de un contacto:

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

Para actualizar una foto de grupo:

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

Para actualizar una foto de equipo:

PUT /teams/{id}/photo/$value

Para actualizar la foto de perfil de un usuario:

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

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type	por ejemplo, image/jpeg. Obligatorio.

Cuerpo de solicitud

En el cuerpo de la solicitud, incluya los datos binarios de la foto.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta o un 204 No Content código de respuesta para actualizar la foto de un equipo.

Ejemplos

Ejemplo 1: Actualización de la foto de perfil de un usuario

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Binary data for the image


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users photo content put --user-id {user-id}

Importante

Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK

Ejemplo 2: Actualización de la foto de un equipo

Solicitud

En el ejemplo siguiente se muestra una solicitud para actualizar una foto de equipo.

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

Binary data for the image


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta teams photo content put --team-id {team-id}

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


Import-Module Microsoft.Graph.Beta.Teams

$params = Binary data for the image

Set-MgBetaTeamPhotoContent -TeamId $teamId -BodyParameter $params

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Actualizar profilePhoto

Permissions

Para actualizar la foto de perfil de un contacto

Para actualizar la foto de perfil de un grupo

Para actualizar la foto de perfil de un equipo

Para actualizar la foto de perfil de un usuario

Solicitud HTTP

Encabezados de solicitud

Cuerpo de solicitud

Respuesta

Ejemplos

Ejemplo 1: Actualización de la foto de perfil de un usuario

Solicitud

Respuesta

Ejemplo 2: Actualización de la foto de un equipo

Solicitud

Respuesta

Comentarios

Comentarios

Recursos adicionales