Referencia de la API de REST de fotos de usuario de Outlook (versión 2.0)
Se aplica a: Exchange Online | Office 365
La API de foto de usuario le permite descargar o configurar la foto de un usuario cuyo buzón está protegido por Azure Active Directory en Office 365.
Nota
La API de fotos de usuario no admite buzones de correo de clientes en dominios de cuentas Microsoft, como Hotmail.com, Live.com, MSN.com, Outlook.com y Passport.com.
¿No está interesado en la versión 2.0 de la API? En el índice de la izquierda, vaya a la sección Referencia de la API de REST de Office 365 y seleccione la versión que desee.
Utilizar la API de REST de fotos de usuario
Autenticación
Como cualquier otra API REST de Outlook, para cada solicitud a la API de foto de usuario de Outlook, debería incluir un token de acceso válido. Obtener un token de acceso requiere que haya registrado e identificado su aplicación y obtenido la autorización correspondiente.
Puede obtener más información sobre algunas opciones de registro y autorización optimizadas para usted. Tenga esto en cuenta a medida que avance con las operaciones específicas en la API de foto de usuario.
Versión de la API
El estado de esta API ha ascendido de versión preliminar a disponibilidad general. Es compatible con las versiones 2.0 y beta de la API de REST de Outlook.
Usuario objetivo
El usuario objetivo puede ser el usuario que ha iniciado sesión o un usuario especificado por un Id. de usuario.
Para obtener más información sobre el uso de esta API e información común a todos los subconjuntos de la API REST de Outlook, consulte Usar la API REST de Outlook.
Operaciones de foto de usuario
Las operaciones de foto de usuario le permiten obtener los metadatos de la foto del usuario y la transmisión en secuencias de la foto en formato binario, y establecer la foto del usuario.
Obtener metadatos de foto
Obtenga información sobre la foto de usuario solicitada, incluido el tipo de contenido, la eTag y el ancho y el alto en píxeles.
Ámbito necesario
Utilice uno de los ámbitos siguientes para obtener metadatos de foto del usuario especificado, que puede ser el usuario que ha iniciado sesión:
- user.readbasic.all
- user.read.all
- user.readwrite.all
También puede usar el siguiente ámbito para obtener metadatos de foto específicamente del usuario que ha iniciado sesión:
- user.read
Obtener los metadatos de la foto más grande disponible
GET https://outlook.office.com/api/v2.0/me/photo
GET https://outlook.office.com/api/v2.0/Users('{user_id}')/photo
| Parámetro opcional | Tipo | Descripción |
|---|---|---|
| Parámetros de URL | ||
| user_id | cadena | La dirección de correo del usuario. |
Solicitud de ejemplo
Esta solicitud obtiene los metadatos de la foto del usuario que ha iniciado sesión.
GET https://outlook.office.com/api/v2.0/me/photo
Ejemplo de datos de respuesta
Los siguientes datos de respuesta muestran los metadatos de la foto. El código de respuesta HTTP es 200.
{
"@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/photo/$entity",
"@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-7d04-b48b-20075df800e5@1717622f-1d94-c0d4-9d74-f907ad6677b4')/photo",
"@odata.mediaContentType": "image/jpeg",
"@odata.mediaEtag": "\"BA09D118\"",
"Id": "240X240",
"Width": 240,
"Height": 240
}
Los siguientes datos de respuesta muestran el contenido de una respuesta cuando no se ha subido ninguna foto para el usuario. El código de respuesta HTTP es 200.
{
"@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/photo/$entity",
"@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-7d04-b48b-20075df800e5@1717622f-1d94-c0d4-9d74-f907ad6677b4')/photo",
"@odata.mediaContentType": "image/gif",
"@odata.mediaEtag": "",
"Id": "1X1",
"Width": 1,
"Height": 1
}
Obtener foto
Obtener la foto de usuario del usuario especificado.
Esta operación permite que un administrador de cuentas empresariales permita que una aplicación obtenga la foto de usuario de cualquier usuario de la cuenta empresarial.
Ámbito necesario
Utilice uno de los ámbitos siguientes para obtener metadatos de foto del usuario especificado, que puede ser el usuario que ha iniciado sesión:
- user.readbasic.all
- user.read.all
- user.readwrite.all
También puede utilizar el ámbito siguiente para obtener la foto específicamente del usuario que ha iniciado sesión:
- user.read
- user.readwrite
Obtener el tamaño más grande disponible
GET https://outlook.office.com/api/v2.0/me/photo/$value
GET https://outlook.office.com/api/v2.0/Users('{user_id}')/photo/$value
| Parámetro opcional | Tipo | Descripción |
|---|---|---|
| Parámetros de URL | ||
| user_id | cadena | La dirección de correo del usuario. |
Solicitud de ejemplo
Esta solicitud obtiene la foto del usuario que ha iniciado sesión.
GET https://outlook.office.com/api/v2.0/me/photo/$value
Content-Type: image/jpg
Datos de respuesta
Contiene los datos binarios de la foto solicitada. El código de respuesta HTTP es 200.
Establecer foto de usuario
Asigna una foto al usuario que ha iniciado sesión. La foto debe estar en binario. Reemplaza cualquier foto existente para ese usuario.
Puede utilizar PATCH o PUT para esta operación en la versión 2.0.
Ámbito necesario
Utilice el siguiente ámbito para establecer la foto del usuario que ha iniciado sesión:
- user.readwrite
PATCH https://outlook.office.com/api/v2.0/me/photo/$value
PATCH https://outlook.office.com/api/v2.0/users('{user_id}')/photo/$value
PUT https://outlook.office.com/api/v2.0/me/photo/$value
PUT https://outlook.office.com/api/v2.0/users('{user_id}')/photo/$value
| Parámetro opcional | Tipo | Descripción |
|---|---|---|
| Parámetros de URL | ||
| user_id | cadena | La dirección de correo del usuario. |
Solicitud de ejemplo
PATCH https://outlook.office.com/api/v2.0/me/photo/$value
Content-Type: image/jpeg
Incluye los datos binarios de la foto en el cuerpo de la solicitud.
Datos de respuesta
Una solicitud con éxito devuelve HTTP 200.
Pasos siguientes
Tanto si está listo para empezar a compilar una aplicación como si simplemente desea obtener más información, tenemos todo lo que necesita.
- Empezar a trabajar con las API de REST de correo, calendario y contactos.
- ¿Desea ver ejemplos? Los tenemos.
O bien, obtenga más información sobre el uso de la plataforma de Office 365: