Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Référence de l'API REST Photo de l'utilisateur Outllook

S’applique à : Exchange Online | Office 365

Cette documentation traite de la version bêta de l'API photo de l'utilisateur en préversion. Les fonctionnalités de la préversion sont sujettes à modification avant la finalisation et peuvent casser le code qui les utilise. Pour cette raison, en général, vous devez utiliser uniquement une version de production d'une API dans votre code de production. Si disponible, v2.0 est actuellement la version préférée.

L'API de photo d'utilisateur vous permet de télécharger ou de définir la photo d'un utilisateur dont la boîte aux lettres est sécurisée via Azure Active Directory sous Office 365.

Remarque L'API de photo d'utilisateur ne prend pas en charge les boîtes aux lettres consommateur dans les domaines de comptes Microsoft, tels que Hotmail.com, Live.com, MSN.com, Outlook.com et Passport.com.

La version bêta de l’API ne vous intéresse pas ? Utilisez le contrôle dans le coin supérieur droit et sélectionnez la version que vous souhaitez.

L'API de photo d'utilisateur vous permet de télécharger ou de définir la photo d'un utilisateur dont la boîte aux lettres est sécurisée via Azure Active Directory sous Office 365.

Remarque L'API de photo d'utilisateur ne prend pas en charge les boîtes aux lettres consommateur dans les domaines de comptes Microsoft, tels que Hotmail.com, Live.com, MSN.com, Outlook.com et Passport.com.

La version 2.0 de l’API ne vous intéresse pas ? Utilisez le contrôle dans le coin supérieur droit et sélectionnez la version que vous souhaitez.

Utilisation de l'API REST de photo d'utilisateur

Authentification

Comme les autres API REST Outlook, pour chaque demande adressée à l'API de photo d'utilisateur Outlook, vous devez inclure un jeton d'accès valide. Pour obtenir un jeton d'accès, vous devez avoir enregistré et identifié votre application et obtenu l'autorisation appropriée. Vous pouvez en savoir plus à propos de certaines options d'enregistrement et d'autorisation simplifiées pour vous. Rappelez-vous en lorsque vous réalisez certaines opérations dans l'API de photo d'utilisateur.

Version de l'API

Cette API a été promue de la préversion au statut de disponibilité générale (GA). Elle est prise en charge dans les versions v2.0 et bêta de l'API REST Outlook.

Utilisateur cible

L'utilisateur cible peut être l'utilisateur connecté ou un utilisateur spécifié par un ID utilisateur.

Pour plus d'informations sur l'utilisation de cette API et obtenir des informations communes à tous les sous-ensembles de l'API REST Outlook, reportez-vous à la rubrique Utiliser l'API REST Outlook.


Opérations de photo d'utilisateur

Les opérations de photo d'utilisateur vous permettent d'obtenir les métadonnées et les flux de photos d'un utilisateur au format binaire, et de définir la photo de cet utilisateur.

En plus de photo entité, l'API Photo de l'utilisateur fournit une collection de photos collection qui est en préversion et disponible uniquement dans la version bêta. La collection photos vous permet d'indiquer des tailles spécifiques de la photo de l'utilisateur qui vous intéresse.

Obtenez des métadonnées de photo

Obtenez des informations sur la photo d'utilisateur demandée, qui comprend le type de contenu, eTag et la largeur et la hauteur en pixels.

Étendue requise Utilisez l'une des étendues suivantes pour obtenir des métadonnées de photo de l'utilisateur spécifié, qui peut être l'utilisateur connecté :

  • user.readbasic.all
  • user.read.all
  • user.readwrite.all

Vous pouvez également utiliser l'étendue suivante pour obtenir des métadonnées de photo de l'utilisateur spécifiquement connecté :

  • user.read

Obtenez les métadonnées pour la plus grande photo disponible

GET https://outlook.office.com/api/beta/me/photo
GET https://outlook.office.com/api/beta/Users('{user_id}')/photo

Obtenez les métadonnées pour toutes les tailles de photo disponibles

GET https://outlook.office.com/api/beta/me/photos
GET https://outlook.office.com/api/beta/Users('{user_id}')/photos

Obtenez les métadonnées pour une taille de photo spécifique

GET https://outlook.office.com/api/beta/me/photos('{size}')
GET https://outlook.office.com/api/beta/Users('{user_id}')/photos('{size}')
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.
taillechaîneTaille d'une photo. La valeur de « 1x1 » est générée automatiquement au cas où une photo n'est pas présente à la fois dans Active Directory et dans la boîte aux lettres.
Si la photo est stockée dans la boîte aux lettres, les tailles prédéfinies sont : « 48x48 », « 64x64 », « 96x96 », « 120x120 », « 240x240 », « 360x360 », « 432x432 », « 504x504 » et « 648x648 ». Si l'utilisateur ne télécharge pas une photo assez grande, alors seules les tailles pouvant être représentées par les plus petites tailles prédéfinies sont disponibles. Par exemple, si l’utilisateur télécharge une photo de 504 x 504 pixels, toutes les tailles de photo seront disponibles pour téléchargement sauf la taille 648 x 648.
Les photos peuvent être de n’importe quelle dimension tant qu'elles sont stockées dans Active Directory.

Exemple de requête Cette requête obtient les métadonnées pour une image de 240 x 240 pixels pour l'utilisateur connecté.

GET https://outlook.office.com/api/beta/me/photos('240x240')

Exemple de données de réponse

Les données de réponse suivantes montrent les métadonnées de la photo. Le code de la réponse HTTP est 200.

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/photo/$entity",
    "@odata.id": "https://outlook.office.com/api/beta/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
}

Les données de réponse suivantes montrent le contenu d'une réponse lorsqu'une photo n'a pas encore été téléchargée pour l'utilisateur. Le code de la réponse HTTP est 200.

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/photo/$entity",
    "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-7d04-b48b-20075df800e5@1717622f-1d94-c0d4-9d74-f907ad6677b4')/photo",
    "@odata.mediaContentType": "image/gif",
    "@odata.mediaEtag": "",
    "Id": "1X1",
    "Width": 1,
    "Height": 1
}

Obtenez les métadonnées pour la plus grande photo disponible

GET https://outlook.office.com/api/v2.0/me/photo
GET https://outlook.office.com/api/v2.0/Users('{user_id}')/photo
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.

Exemple de requête Cette requête obtient les métadonnées de la photo de l’utilisateur connecté.

GET https://outlook.office.com/api/v2.0/me/photo

Exemple de données de réponse

Les données de réponse suivantes montrent les métadonnées de la photo. Le code de la réponse HTTP est 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
}

Les données de réponse suivantes montrent le contenu d'une réponse lorsqu'une photo n'a pas encore été téléchargée pour l'utilisateur. Le code de la réponse HTTP est 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
}

Obtenez la photo

Obtenez la photo de l'utilisateur de l'utilisateur spécifié.

Cette opération permet à un administrateur client de laisser une application obtenir la photo de l'utilisateur d'un quelconque utilisateur du client.

Étendue requise Utilisez l'une des étendues suivantes pour obtenir la photo de l'utilisateur spécifié, qui peut être l'utilisateur connecté :

  • user.readbasic.all
  • user.read.all
  • user.readwrite.all

Vous pouvez également utiliser l'étendue suivante pour obtenir la photo de l'utilisateur connecté en particulier :

  • user.read
  • user.readwrite

Obtenez la plus grande taille disponible

GET https://outlook.office.com/api/beta/me/photo/$value
GET https://outlook.office.com/api/beta/Users('{user_id}')/photo/$value

Obtenez la photo d'une taille spécifique

GET https://outlook.office.com/api/beta/me/photos('{size}')/$value
GET https://outlook.office.com/api/beta/Users('{user_id}')/photos('{size}')/$value
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.
taillechaîneTaille d'une photo. La valeur de « 1x1 » est générée automatiquement au cas où une photo n'est pas présente à la fois dans Active Directory et dans la boîte aux lettres.
Si la photo est stockée dans la boîte aux lettres, les tailles prédéfinies sont : « 48x48 », « 64x64 », « 96x96 », « 120x120 », « 240x240 », « 360x360 », « 432x432 », « 504x504 » et « 648x648 ». Si l'utilisateur ne télécharge pas une photo assez grande, alors seules les tailles pouvant être représentées par les plus petites tailles prédéfinies sont disponibles. Par exemple, si l’utilisateur télécharge une photo de 504 x 504 pixels, toutes les tailles de photo seront disponibles pour téléchargement sauf la taille 648 x 648.
Les photos peuvent être de n’importe quelle dimension tant qu'elles sont stockées dans Active Directory.

Exemple de demande

Cette requête obtient la photo pour l’utilisateur connecté.

GET https://outlook.office.com/api/beta/me/photo/$value
Content-Type: image/jpg

Obtenez la plus grande taille 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
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.

Exemple de demande

Cette requête obtient la photo pour l’utilisateur connecté.

GET https://outlook.office.com/api/v2.0/me/photo/$value
Content-Type: image/jpg

Données de réponse

Contient les données binaires de la photo demandée. Le code de la réponse HTTP est 200.


Paramétrez la photo de l'utilisateur

Assigner une photo à l'utilisateur spécifié. La photo doit être en binaire. Elle remplace toute photo existante pour cet utilisateur.

Cette opération permet à un administrateur client de laisser une application paramétrer la photo de l'utilisateur d'un quelconque utilisateur du client. Utilisez uniquement PUT pour cette opération dans la version bêta.

Étendue requise

Utilisez l'étendue suivante pour définir la photo de l'utilisateur spécifié, qui peut être n'importe quel utilisateur du client ou l'utilisateur connecté :

  • user.readwrite.all

Vous pouvez également utiliser l'étendue suivante pour paramétrer la photo de l'utilisateur connecté en particulier :

  • user.readwrite
PUT https://outlook.office.com/api/beta/me/photo/$value
PUT https://outlook.office.com/api/beta/users('{user_id}')/photo/$value
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.

Exemple de demande

PUT https://outlook.office.com/api/beta/me/photo/$value
Content-Type: image/jpeg

Incluez les données binaires de la photo dans le corps de la requête.

Attribuez une photo à l'utilisateur connecté. La photo doit être en binaire. Elle remplace toute photo existante pour cet utilisateur.

Vous pouvez utiliser PATCH ou PUT pour cette opération dans la version 2.0.

Étendue requise Utilisez l'étendur suivante pour définir la photo de l'utilisateur connecté :

  • 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
Paramètre facultatifTypeDescription
Paramètres URL
user_idchaîneAdresse e-mail de l’utilisateur.

Exemple de demande

PATCH https://outlook.office.com/api/v2.0/me/photo/$value
Content-Type: image/jpeg

Incluez les données binaires de la photo dans le corps de la requête.

Données de réponse

Une requête réussie renvoie HTTP 200.


Étapes suivantes

Que vous soyez sur le point de générer une application ou que vous souhaitiez simplement en apprendre plus, nous avons ce qu’il vous faut.

Ou, découvrez-en plus sur l’utilisation de la plateforme Office 365 :

© 2018 Microsoft