Actualizar profilePhoto
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) | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
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) | ProfilePhoto.ReadWrite.All | User.ReadWrite, User.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | User.ReadWrite | No admitida. |
Aplicación | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
Nota:
- 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 ProfilePhoto.ReadWrite.All o 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
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
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content